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; с облачными эмбеддингами фрагменты кода уходят во внешние сервисы.
Настройка клиентов
{
"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 для ИИ-ассистента.
Git
Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.
GitDiagram
Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.
git-mcp
Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.