SocratiCode
Локальный индекс кодовой базы для агентов: гибридный поиск, графы зависимостей и анализ последствий изменений
Установка
{
"mcpServers": {
"socraticode": {
"command": "npx",
"args": ["-y", "--prefer-online", "socraticode@latest"]
}
}
}Нужен запущенный Docker
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
SocratiCode индексирует репозиторий и отдает агенту MCP-инструменты для поиска по коду, где семантический поиск объединен с BM25. Он строит графы зависимостей для многих языков, находит циклические импорты и показывает, какие символы затронет правка. В индекс можно добавить схемы баз, спецификации API и конфигурации инфраструктуры. По умолчанию Qdrant и Ollama поднимаются в Docker на вашей машине, индекс обновляется при изменении файлов и может использоваться несколькими агентами сразу.
Для кого. Для разработчиков, которые работают с агентами в больших репозиториях и не хотят отправлять код наружу.
Подходит, если
- Агент тратит много токенов на grep и чтение файлов в большом репозитории
- Нужно понять, что сломается при изменении функции или модуля
- Нужна карта архитектуры и циклических зависимостей
Не подходит, если
- Проект маленький и агенту хватает обычного поиска
- На машине нельзя запускать Docker
Пример запроса к агенту
Проиндексируй репозиторий и покажи, какие модули зависят от сервиса авторизацииОграничения
Нужны Node.js 18.17 или новее и запущенный Docker для локальных Qdrant и Ollama. Первая индексация большого репозитория занимает время и ресурсы. Облачные эмбеддинги OpenAI или Gemini опциональны и требуют ключей. Лицензия AGPL-3.0, облачная версия в закрытой бете.
Как отключить. Удалите блок socraticode из конфигурации MCP или удалите плагин в Claude Code, затем остановите контейнеры Docker проекта.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Проверка безопасности
- Читает весь код проекта и запускает контейнеры Docker
Коротко о README
README описывает SocratiCode как движок контекста кодовой базы и приводит собственный бенчмарк на репозитории VS Code против поиска через grep. Установка возможна плагином для Claude Code, Codex и Cursor, расширением VS Code или как MCP-сервер через npx в любом клиенте. Подробно разобраны переменные окружения, игнор-правила, артефакты контекста, ресурсы Docker и обновление. В репозитории есть скиллы codebase-exploration и codebase-management.
Частые вопросы
Уходит ли код в облако?
По умолчанию нет: эмбеддинги и векторная база работают локально в Docker, ключи API не нужны.
Чем плагин отличается от MCP-сервера?
Плагины для Claude Code, Codex и Cursor добавляют скиллы с инструкциями, прямая MCP-установка ставит только движок.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything
Актуальная документация и примеры кода нужной версии библиотеки прямо в контексте агента, через MCP или CLI со скиллом