Kodit MCP
Сервер индексирует репозитории Git и документы и дает ассистенту поиск через MCP: BM25, семантика, grep и визуальный поиск
- 127 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Сервер клонирует и индексирует репозитории Git, а поиск по умолчанию доступен без ключа.
- Обогащения передают исходный код настроенному провайдеру LLM.
Установка
- Работает в
Ручная установка
docker run -p 8080:8080 registry.helix.ml/helix/kodit:latestПервый вариант из README: SQLite и встроенная модель эмбеддингов, ключи API не нужны.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер клонирует и индексирует репозитории Git, а поиск по умолчанию доступен без ключа.
- Обогащения передают исходный код настроенному провайдеру LLM.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Kodit разбирает репозитории Git на фрагменты и отдает их MCP-совместимым ассистентам. Перед написанием кода ассистент запрашивает у Kodit примеры из ваших проектов и получает актуальные фрагменты. Для разных задач есть отдельные инструменты: `kodit_keyword_search` (BM25), `kodit_semantic_search`, `kodit_grep`, `kodit_ls`, `kodit_read_resource` и визуальный поиск `kodit_visual_search`. Документы тоже индексируются: PDF, Word, PowerPoint и таблицы растрируются, поэтому поиск идет по коду и по документации вместе. Необязательные обогащения на LLM составляют документацию по архитектуре, API и схеме базы данных, примеры использования и описания коммитов. Для базовой работы внешние сервисы не нужны, встроена модель эмбеддингов и SQLite.
Для кого. Командам, у которых код и документация лежат в нескольких репозиториях, и ассистент должен писать код по образцам из собственных проектов.
Подходит, если
- Ассистент придумывает API с нуля, хотя в соседнем репозитории компании уже есть готовый пример.
- Нужно найти по смыслу фрагмент, который не удается найти по ключевым словам.
- Документация лежит в PDF и презентациях, а ответ должен ссылаться на страницу.
- Новому разработчику требуется карта архитектуры репозитория и схема базы данных.
Не подходит, если
- Репозиторий один и небольшой: встроенного поиска ассистента достаточно.
- Исходный код нельзя передавать LLM для обогащений: эти инструменты работают только с настроенным провайдером.
- Нужна защита поиска: конечные точки поиска по умолчанию открыты.
Пример запроса к агенту
Проиндексируй репозиторий, найди в Kodit примеры обработки заказов в наших проектах и напиши новый обработчик по их образцу.MCP
- Транспорт
- http
- Авторизация
- не нужна
Переменные окружения
API_KEYSсекрет- Ключи API через запятую для операций записи (создание репозиториев, запуск синхронизации). Поиск по умолчанию открыт.
Ограничения
Инструменты обогащений (`kodit_architecture_docs`, `kodit_api_docs`, `kodit_database_schema`, `kodit_cookbook`, `kodit_wiki` и `kodit_commit_description`) работают только при настроенном провайдере LLM. Ключи в `API_KEYS` защищают операции записи, а поиск по умолчанию открыт, поэтому внешний сервер стоит закрыть сетью. Для продакшена авторы советуют PostgreSQL с VectorChord вместо SQLite. Некоторые ассистенты сами не вызывают Kodit, и тогда нужно правило в инструкциях проекта.
Как отключить. Удалите подключение `kodit` из настроек MCP клиента и остановите контейнер или процесс `kodit serve`. Данные индекса лежат в `~/.kodit`, их удаляют отдельно.
Частые вопросы
Как подключить Kodit к Claude Code?
Выполните `claude mcp add --transport http kodit http://localhost:8080/mcp`. Если сервер на другой машине, замените адрес на свой.
Нужны ли ключи API?
Для базовой работы нет: Docker-образ стартует с SQLite и встроенной моделью эмбеддингов. Ключ LLM понадобится только для обогащений, а `API_KEYS` защищают операции записи.
Какие клиенты поддержаны?
В README есть настройки для Claude Code, Cursor, Cline и Kilo Code. Подойдет и любой клиент с поддержкой MCP по HTTP.
Что делать, если ассистент не вызывает Kodit?
Добавьте в правила проекта или системную подсказку требование вызывать инструменты поиска Kodit перед написанием кода. В Cursor это файл `.cursor/rules/kodit.mdc` с `alwaysApply: true`.
Можно ли использовать Kodit как библиотеку Go?
Да. Пакет `github.com/helixml/kodit` встраивается в приложение на Go, на этом основана интеграция в платформу Helix. Для удаленного сервера есть и сгенерированный HTTP-клиент.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер индексирует локальный репозиторий через tree-sitter и дает агенту поиск по коду, список файлов и сводку по структуре файла
MCP-сервер и CLI для исследования кода: поиск и разбор по вашему проекту и по всему GitHub с экономией токенов
Локальный индекс кодовой базы для агентов: гибридный поиск, графы зависимостей и анализ последствий изменений
codesearch ищет по коду сразу в нескольких репозиториях гибридным поиском и работает офлайн, без GPU и Docker.
Docs MCP Server
Grounded Docs MCP Server
Локальный MCP-сервер: индексирует документацию из сайтов, GitHub, npm, PyPI и файлов и дает агенту поиск по нужной версии
Локальный семантический индекс кода: агент ищет по смыслу, затем идет к определениям, вызовам и путям зависимостей
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Kodit (эта карточка) | нет | не нужна | 127 | |
| Claude Context | да | API-ключ | 12 690 | claude-context строит векторный индекс одной кодовой базы; Kodit собирает несколько репозиториев и документы и добавляет grep, BM25 и визуальный поиск. |
| code-index-mcp | нет | не нужна | 162 | code-index-mcp хранит индекс кода в SQLite с графом вызовов; Kodit ориентирован на примеры из ваших проектов и документы в PDF и Office. |
Коротко о README
README объясняет назначение сервера, быстрый запуск в Docker или бинарным файлом, подключение к четырем ассистентам, список из 15 инструментов MCP, REST API, использование как библиотеки Go и настройки для продакшена.