KotaDB MCP
KotaDB индексирует репозиторий локально и отвечает Claude Code, что сломается при правке файла: зависимости и поиск по смыслу.
- 100 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Сервер читает все файлы репозитория и строит индекс на диске.
Установка
- Работает в
Ручная установка
{"mcpServers":{"kotadb":{"command":"bunx","args":["kotadb@next","--stdio"]}}}Конфигурация из README для `~/.claude/mcp.json`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер читает все файлы репозитория и строит индекс на диске.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
KotaDB помогает Claude Code понимать структуру кодовой базы. Репозиторий индексируется один раз, после чего агент задает вопросы вроде «что сломается, если я поменяю этот файл» и получает ответы с учетом зависимостей. Индекс и запросы остаются на вашем компьютере. MCP-сервер запускается через `bunx kotadb@next --stdio` и сам индексирует код при первом обращении. Инструменты: `search_dependencies` показывает, кто зависит от файла, `analyze_change_impact` оценивает последствия рефакторинга, `search_code` ищет по смыслу, а `list_recent_files` показывает недавно проиндексированное. Основа проекта — Bun, TypeScript и SQLite.
Для кого. Разработчикам, которые работают с Claude Code в большом репозитории и хотят знать последствия правки до ее внесения.
Подходит, если
- Перед рефакторингом нужно узнать, какие файлы импортируют изменяемый модуль.
- Надо найти код про авторизацию по смыслу, даже если слова в нем другие.
- Нужна оценка влияния правки на соседние файлы.
- Код не должен уходить в облако, индекс остается локальным.
Не подходит, если
- В проекте мало файлов, и хватает обычного поиска.
- Bun версии 1.1 или новее установить нельзя.
- Нужен индекс, общий для всей команды в облаке.
Пример запроса к агенту
Какие файлы зависят от src/index.ts и что сломается, если я переименую экспортируемую функцию?MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Нужен Bun версии 1.1 или новее. В конфигурации указана версия пакета `kotadb@next`, то есть сборка предварительная, поведение и набор инструментов могут меняться. Индекс строится из исходных файлов репозитория и хранится в базе SQLite на вашем компьютере, поэтому при чувствительном коде ограничьте доступ к каталогу данных. Оценка влияния опирается на найденные зависимости и может пропустить связи, которые создаются динамически.
Как отключить. Уберите запись `kotadb` из `~/.claude/mcp.json` и удалите каталог индекса. Файлы проекта сервер не меняет.
Частые вопросы
Как подключить к Claude Code?
Добавьте в `~/.claude/mcp.json` сервер с командой `bunx` и аргументами `kotadb@next --stdio`.
Нужна ли ручная индексация?
Нет, код индексируется автоматически при первом обращении.
Какие инструменты есть?
`search_dependencies`, `analyze_change_impact`, `search_code` и `list_recent_files`.
Уходит ли код в облако?
Нет, работа идет локально, индекс лежит в SQLite на вашем компьютере.
Что нужно для запуска?
Bun версии 1.1 или новее.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальный индекс кодовой базы для агентов: гибридный поиск, графы зависимостей и анализ последствий изменений
MCP-сервер, который строит граф кода: функции, классы, вызовы и маршруты, и отвечает на структурные запросы агента локально
Сервер индексирует репозитории Git и документы и дает ассистенту поиск через MCP: BM25, семантика, grep и визуальный поиск
MCP-сервер индексирует локальный репозиторий через tree-sitter и дает агенту поиск по коду, список файлов и сводку по структуре файла
Локальный семантический индекс кода: агент ищет по смыслу, затем идет к определениям, вызовам и путям зависимостей
CKB, Code Knowledge Backend, строит из кода базу знаний: символы, влияние правок, владельцы, мертвый код и проблемные места.
Коротко о README
Описание обещает быстрые ответы о коде за пять минут настройки и показывает конфигурацию MCP. Таблица связывает типичные вопросы с инструментами, дальше объяснено, почему выбран stdio.