Codanna — семантический поиск по коду для AI-агента

MCP-сервер, который превращает Клёпу в инструмент со «зрением» для всего вашего проекта: графы вызовов, семантический поиск, точный рефакторинг.

Что такое Codanna

Codanna — мощный MCP (Model Context Protocol) сервер, который предоставляет Клёпе структурированные знания о вашей кодовой базе. Вместо бесконечного поиска по файлам Codanna позволяет ИИ понимать структуру кода, отслеживать связи между функциями и находить реализации с хирургической точностью.

Ключевое преимущество. Codanna понимает структуру кода. Она знает, что parseConfig — это функция, которая вызывает validateSchema, а не просто совпадение строк.

Возможности

Семантический поиск

Находите функции по тому, что они делают, а не по названиям. Естественные запросы к коду и документации.

Отслеживание связей

Графы вызовов, реализации и зависимости. Прослеживайте связи между кодом в разных файлах.

Поиск по документации

Индексируйте Markdown и текстовые файлы для RAG. Запрашивайте документацию вместе с кодом.

MCP-протокол

Нативная интеграция с Claude, Gemini, Codex и другими AI-ассистентами через стандартный протокол.

Подключение

1. Установка Codanna

Выберите способ установки:

Быстрая:

curl -fsSL --proto '=https' --tlsv1.2 https://install.codanna.sh | sh

Homebrew:

brew install codanna

Cargo:

cargo install codanna

2. Инициализация проекта

Инициализируйте Codanna в каталоге проекта:

codanna init

Эта команда создаст конфигурационный каталог .codanna/.

3. Индексация кода

Постройте индекс по исходному коду:

codanna index src

Замените src на путь к вашей исходной папке. Codanna проанализирует весь код и построит индекс для быстрого поиска.

Совет. Для документации:

codanna documents add-collection docs ./docs
codanna documents index

4. Интеграция с Клёпой

Добавьте MCP-сервер в конфигурацию Клёпы:

{
  "mcpServers": {
    "codanna": {
      "command": "codanna",
      "args": ["serve", "--watch", "--watch-interval", "5"]
    }
  }
}

Перезапустите VS Code, чтобы изменения вступили в силу.

Что улучшится в работе с Клёпой

Мгновенные ответы вместо долгого поиска

Вместо «где эта функция вызывается?» — мгновенный граф вызовов. Вместо grep — точные результаты с пониманием контекста.

Пример: «Где обрабатываются ошибки авторизации?»

Понимание архитектуры проекта

Codanna помогает Клёпе понимать структуру вашего проекта, связи между компонентами и архитектурные паттерны.

Пример: «Какие компоненты зависят от UserService?»

Точный рефакторинг

Перед изменением Клёпа сможет точно определить, какие части системы затронет изменение, и предупредить о возможных проблемах.

Пример: «Что сломается, если я изменю сигнатуру этого метода?»

Контекстная документация

Клёпа сможет находить релевантную документацию вместе с кодом, что делает ответы более полными и точными.

Пример: «Найди примеры использования этой функции в документации»

Примеры запросов

Поиск и анализ

«Где реализована обработка JWT-токенов?»
«Найди все функции, работающие с базой данных»
«Покажи архитектуру авторизации»

Рефакторинг

«Какие файлы используют этот компонент?»
«Что сломается при изменении этого API?»
«Найди дублирующийся код»

Обучение

«Объясни эту архитектуру»
«Как работает система кеширования?»
«Где находятся бизнес-правила валидации?»

Документация

«Найди гайд по настройке окружения»
«Какие есть примеры использования API?»
«Где описаны лучшие практики?»

Технические характеристики

Производительность

Скорость поиска — < 10 мс на запрос
Парсинг — 75 000+ символов/сек

Поддерживаемые языки

Подключить Codanna

Открытый исходный код. Следуйте документации, чтобы установить и подключить к Клёпе.

Документация GitHub