SocratiCode

Локальный индекс кодовой базы для агентов: гибридный поиск, графы зависимостей и анализ последствий изменений

MCP-серверСредний риск

giancarloerra/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, субагенты и ревью кода

ПлагинСредний риск286,6 тыс.
Выбор редакции

Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура

СкиллНизкий риск262 тыс.

Референсные MCP-серверы

Model Context Protocol servers

Выбор редакции

Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything

MCP-серверСредний риск90,3 тыс.
Выбор редакции

Актуальная документация и примеры кода нужной версии библиотеки прямо в контексте агента, через MCP или CLI со скиллом

MCP-серверСредний риск62 тыс.