Codanna MCP
Локальный MCP-сервер и CLI для агентов: семантический поиск по коду, графы вызовов и анализ влияния изменений
- 761 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Читает и индексирует исходный код проекта
- Запускает локальный сервер; при опциональных удаленных эмбеддингах данные уходят во внешний API
Установка
- Работает в
Ручная установка
curl -fsSL --proto '=https' --tlsv1.2 https://install.codanna.sh | shУстановка для macOS, Linux и WSL.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает и индексирует исходный код проекта
- Запускает локальный сервер; при опциональных удаленных эмбеддингах данные уходят во внешний API
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Codanna индексирует репозиторий на диске и отдает агенту связанную картину кода за один вызов: контекст символа, сигнатуру, вызываемые и вызывающие функции и радиус влияния изменения. Он объединяет поиск по символам, семантический поиск, графы вызовов, отслеживание зависимостей и RAG по документам, заменяя цикл grep и чтения файлов одним ответом. Работать можно как постоянным MCP-сервером для длинной сессии или разовыми командами CLI для слэш-команд, хуков и CI. Индекс и модель эмбеддингов живут локально, по умолчанию исходники никуда не уходят. Поддерживает Claude Code, Cursor, Windsurf, Codex, Gemini и другие MCP-клиенты, разбирает пятнадцать языков.
Для кого. Для разработчиков, которым нужно, чтобы агент понимал структуру кода, а не искал по строкам.
Подходит, если
- Нужно понять, где вызывается функция и что сломается при ее правке
- Нужен семантический поиск по смыслу, а не по названию
- Нужны быстрые ответы по коду в слэш-командах и CI без демона
Не подходит, если
- Нужна поддержка языка, которого нет в списке из пятнадцати
- Работаете на Windows и не готовы к экспериментальному статусу
Пример запроса к агенту
Найди, где обрабатываются ошибки, и покажи что сломается при правке этой функцииMCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
CODANNA_EMBED_API_KEYсекрет- Ключ для удаленных эмбеддингов через совместимый с OpenAI адрес, нужен только при опциональном удаленном режиме
Ограничения
Для модели эмбеддингов нужно около 150 МБ, она скачивается при первом запуске. Сборка из исходников требует Rust 1.85 и на Linux пакетов pkg-config и libssl-dev. Поддержка Windows экспериментальная. Удаленные эмбеддинги через совместимый с OpenAI адрес включаются отдельно и тогда данные уходят во внешний API, ключ хранится только в окружении.
Как отключить. Удалите запись codanna из конфигурации MCP, при желании удалите пакет и папку индекса .codanna в проекте.
Частые вопросы
Уходит ли код в сеть?
По умолчанию нет. Индекс и модель эмбеддингов работают локально, удаленные эмбеддинги через внешний API включаются отдельно.
Обязателен ли постоянный сервер?
Нет. Те же инструменты доступны разовыми командами codanna mcp без демона, это удобно для слэш-команд, хуков и CI.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальный индекс кодовой базы для агентов: гибридный поиск, графы зависимостей и анализ последствий изменений
MCP-сервер CodeAlive: агент ищет по смыслу и точно в больших кодовых базах и разбирает связи вызовов, не читая репозиторий целиком
MCP-сервер и CLI на Rust: граф вызовов и гибридный семантический поиск по коду для Claude Code и Codex
MCP-сервер ищет определения и смысловые фрагменты кода по локальному индексу, объединяя векторы и полнотекстовый поиск.
MCP-сервер, который индексирует код через tree-sitter и отдает агенту отдельные функции и классы вместо целых файлов
MCP-сервер семантического поиска по кодовой базе: индексирует проект в векторной базе и отдает агенту только нужные фрагменты
Коротко о README
README описывает Codanna как локальный сервер интеллекта кода и CLI для агентов на Rust. Один вызов возвращает символ, документацию, сигнатуру, вызовы в обе стороны и анализ влияния, а не просто совпадения по строкам. Инструменты доступны постоянным MCP-сервером с транспортами stdio, HTTP и HTTPS или разовыми командами CLI. Ставится скриптом установки, через Homebrew, Nix или Cargo, есть плагин для Claude Code с визуализациями x-ray и graph. Поддерживает пятнадцать языков и работает локально. Лицензия Apache 2.0.