SocratiCode MCP
Локальный индекс кодовой базы для агентов: гибридный поиск, графы зависимостей и анализ последствий изменений
- 3 358 ★ репозитория
- Последний коммит
- AGPL-3.0
Расширенный доступ
Почему такой уровень
- Читает весь код проекта и запускает контейнеры Docker
Установка
- Работает в
Ручная установка
{
"mcpServers": {
"socraticode": {
"command": "npx",
"args": ["-y", "--prefer-online", "socraticode@latest"]
}
}
}Нужен запущенный Docker
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает весь код проекта и запускает контейнеры Docker
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
SocratiCode индексирует репозиторий и отдает агенту MCP-инструменты для поиска по коду, где семантический поиск объединен с BM25. Он строит графы зависимостей для многих языков, находит циклические импорты и показывает, какие символы затронет правка. В индекс можно добавить схемы баз, спецификации API и конфигурации инфраструктуры. По умолчанию Qdrant и Ollama поднимаются в Docker на вашей машине, индекс обновляется при изменении файлов и может использоваться несколькими агентами сразу.
Для кого. Для разработчиков, которые работают с агентами в больших репозиториях и не хотят отправлять код наружу.
Подходит, если
- Агент тратит много токенов на grep и чтение файлов в большом репозитории
- Нужно понять, что сломается при изменении функции или модуля
- Нужна карта архитектуры и циклических зависимостей
Не подходит, если
- Проект маленький и агенту хватает обычного поиска
- На машине нельзя запускать Docker
Пример запроса к агенту
Проиндексируй репозиторий и покажи, какие модули зависят от сервиса авторизацииMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Нужны Node.js 18.17 или новее и запущенный Docker для локальных Qdrant и Ollama. Первая индексация большого репозитория занимает время и ресурсы. Облачные эмбеддинги OpenAI или Gemini опциональны и требуют ключей. Лицензия AGPL-3.0, облачная версия в закрытой бете.
Как отключить. Удалите блок socraticode из конфигурации MCP или удалите плагин в Claude Code, затем остановите контейнеры Docker проекта.
Частые вопросы
Уходит ли код в облако?
По умолчанию нет: эмбеддинги и векторная база работают локально в Docker, ключи API не нужны.
Чем плагин отличается от MCP-сервера?
Плагины для Claude Code, Codex и Cursor добавляют скиллы с инструкциями, прямая MCP-установка ставит только движок.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер, который индексирует код через tree-sitter и отдает агенту отдельные функции и классы вместо целых файлов
MCP-сервер, который строит граф кода: функции, классы, вызовы и маршруты, и отвечает на структурные запросы агента локально
Локальный граф кода для агентов: MCP-сервер отдает точки входа, связи символов и радиус влияния изменений за один вызов
Локальный MCP-сервер и CLI для агентов: семантический поиск по коду, графы вызовов и анализ влияния изменений
MCP сервер структурного поиска по коду для агентов: находит нужный файл по смыслу запроса и работает локально
MCP-сервер индексирует локальный репозиторий через tree-sitter и дает агенту поиск по коду, список файлов и сводку по структуре файла
Коротко о README
README описывает SocratiCode как движок контекста кодовой базы и приводит собственный бенчмарк на репозитории VS Code против поиска через grep. Установка возможна плагином для Claude Code, Codex и Cursor, расширением VS Code или как MCP-сервер через npx в любом клиенте. Подробно разобраны переменные окружения, игнор-правила, артефакты контекста, ресурсы Docker и обновление. В репозитории есть скиллы codebase-exploration и codebase-management.