socraticode

socraticode — MCP-сервер сообщества (автор — giancarloerra). Локальная индексация кодовой базы, семантический поиск и граф зависимостей. Лицензия AGPL-3.0.

Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
giancarloerra
Лицензия
AGPL-3.0
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
typescript

Уровень риска: high

Читает весь код проекта, управляет контейнерами Docker; с облачными эмбеддингами фрагменты кода уходят во внешние сервисы.

Настройка клиентов

codex
{
    "code": "codex mcp add socraticode -- npx -y --prefer-online socraticode@latest\ncodex mcp list",
    "lang": "bash",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

SocratiCode — открытый движок контекста кодовой базы для ИИ-агентов. Он индексирует весь проект и даёт агенту гибридный семантический и полнотекстовый поиск по коду, граф зависимостей и анализ связей между символами. По умолчанию всё работает локально в Docker: ключи API не нужны, код не покидает вашу машину.

По замерам авторов на репозитории VS Code (2,45 млн строк) агент с SocratiCode расходует на 61% меньше контекста, делает на 84% меньше вызовов инструментов и работает в 37 раз быстрее, чем при поиске через grep.

Основное:

  • Индексация: файлы делятся по границам функций и классов с помощью разбора AST (ast-grep). После первой индексации обновляются только изменённые файлы. Индексация идёт пакетами по 50 файлов и продолжается с места остановки после сбоя. Можно включить слежение за изменениями файлов.
  • Поиск (codebase_search): гибридный — векторный и BM25 — с фильтрами по пути и языку, в том числе по связанным проектам.
  • Граф зависимостей для 19+ языков: импорты и зависимые файлы, циклические зависимости, диаграмма Mermaid или интерактивная HTML-схема.
  • Анализ влияния: какие файлы затронет изменение (codebase_impact), трассировка выполнения от точки входа (codebase_flow), определение, вызывающие и вызываемые для символа (codebase_symbol).
  • Артефакты контекста: поиск по описанным в .socraticodecontextartifacts.json материалам — например, схемам и документации.
  • Гибкие эмбеддинги: Ollama в Docker (по умолчанию), локальная Ollama с доступом к GPU, OpenAI или Google; Qdrant — встроенный или свой.

Кому подойдёт

  • Разработчикам больших проектов: агент находит нужный код по смыслу, а не перебором grep.
  • Тем, кто делает рефакторинг: оценка влияния изменений и поиск циклических зависимостей.
  • Командам с требованиями к приватности: полностью локальная работа без отправки кода наружу.

Похожие серверы — в категории разработка.

Установка

Нужны Docker (в нём работают векторная база Qdrant и по умолчанию Ollama для эмбеддингов) и Node.js 18.17+ с npx. В стандартном режиме Docker должен быть запущен. В macOS и Windows контейнеры не имеют доступа к GPU, поэтому для средних и больших проектов авторы советуют поставить Ollama нативно — SocratiCode найдёт её автоматически. Сервер запускается через npx -y --prefer-online socraticode@latest.

Подключение к клиентам

Команды и конфиг приведены дословно из README. Для Claude Code и Codex есть также плагины со встроенными навыками. Общий порядок — в инструкции как подключить MCP.

claude mcp add --scope user socraticode -- npx -y --prefer-online socraticode@latest
claude mcp list

Для клиентов с форматом mcpServers README приводит такой же блок с командой npx.

Проверка

Попросите агента проверить окружение — codebase_health покажет состояние Docker, Qdrant и провайдера эмбеддингов. Затем запустите индексацию проекта через codebase_index.

Примеры задач

Проиндексируй этот проект и найди, где обрабатывается авторизация пользователей.
Покажи, какие файлы сломаются, если я изменю функцию parseConfig, и найди циклические зависимости.

Риски

Сервер читает весь код проекта и хранит индекс в Qdrant. По умолчанию данные остаются на машине. Если выбрать эмбеддинги OpenAI или Google либо облачный Qdrant, фрагменты кода будут уходить во внешние сервисы. Сервер управляет контейнерами Docker и может удалять индексы проектов.

Как снизить риски: для закрытого кода оставьте локальные Ollama и Qdrant. Проверяйте правила исключения файлов, чтобы секреты не попали в индекс. Лицензия — AGPL-3.0.

Частые вопросы

Нужны ли ключи API?

Нет. В стандартной настройке Ollama и Qdrant работают в Docker на вашей машине. Ключи нужны, только если выбрать эмбеддинги OpenAI или Google.

Нужно ли переиндексировать проект после каждого изменения?

Нет. После первой индексации обновляются только изменённые файлы, а слежение за файлами поддерживает индекс актуальным.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

GitHub MCP Server

Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Git

Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.

Риск: high Лицензия: NOASSERTION ★ 92 089

GitDiagram

Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.

Риск: medium Лицензия: MIT ★ 18 997

git-mcp

Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.

Риск: medium Лицензия: Apache-2.0 ★ 8 527

Источники