socraticode — MCP-сервер для Claude Code: что делает и как установить
Индексирует кодовую базу, строит графы зависимостей и запускает гибридный поиск по коду через Qdrant.
claude mcp add socraticode -e OPENAI_API_KEY=<OPENAI_API_KEY> -e GOOGLE_API_KEY=<GOOGLE_API_KEY> -e OLLAMA_API_KEY=<OLLAMA_API_KEY> -e LMSTUDIO_API_KEY=<LMSTUDIO_API_KEY> -e LITELLM_API_KEY=<LITELLM_API_KEY> -e QDRANT_API_KEY=<QDRANT_API_KEY> -- npx -y socraticodeЧто делает socraticode
Инструмент индексирует локальные репозитории и передаёт контекст кодовой базы в ИИ-ассистент. Внутри работают гибридный поиск через объединение BM25 и векторных эмбеддингов по алгоритму RRF, разбиение кода с учётом синтаксического дерева AST и анализ связей между символами для 18 языков программирования.
Локальный запуск опирается на Docker и векторную базу Qdrant, поэтому данные остаются на рабочей машине. При необходимости подключаются внешние провайдеры эмбеддингов: OpenAI, Google Gemini или локальный Ollama. Без запущенного Docker или настроенного внешнего сервиса сервер работать не сможет.
Встроенный наблюдатель отслеживает правки в файлах и обновляет индекс прямо во время работы. Индексация сохраняет контрольные точки при сбоях и поддерживает параллельную работу нескольких агентов на одной кодовой базе.
Какие задачи решает
- найти нужные фрагменты через гибридный семантический и текстовый поиск
- оценить радиус влияния правок функции перед рефакторингом
- построить граф зависимостей и выявить циклические вызовы
- проиндексировать конфигурации инфраструктуры, схемы баз данных и документацию API
Примеры запросов агенту
- Найди все обработчики авторизации и покажи их связи с базой данных
- Оцени радиус влияния изменений функции calculateBilling перед рефакторингом
- Покажи циклические зависимости между модулями проекта
Как установить socraticode
Командой платформы
claude mcp add socraticode -e OPENAI_API_KEY=<OPENAI_API_KEY> -e GOOGLE_API_KEY=<GOOGLE_API_KEY> -e OLLAMA_API_KEY=<OLLAMA_API_KEY> -e LMSTUDIO_API_KEY=<LMSTUDIO_API_KEY> -e LITELLM_API_KEY=<LITELLM_API_KEY> -e QDRANT_API_KEY=<QDRANT_API_KEY> -- npx -y socraticodeВместо <…> подставьте свои значения. Ещё 12 переменных окружения — в README сервера
Командой платформы
codex mcp add socraticode --env EMBEDDING_PROVIDER=<EMBEDDING_PROVIDER> --env OPENAI_API_KEY=<OPENAI_API_KEY> --env GOOGLE_API_KEY=<GOOGLE_API_KEY> --env OLLAMA_URL=<OLLAMA_URL> --env EMBEDDING_MODEL=<EMBEDDING_MODEL> -- npx -y socraticodeВместо <…> подставьте свои значения. Ещё 12 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"socraticode": {
"command": "npx",
"args": [
"-y",
"socraticode"
],
"env": {
"EMBEDDING_PROVIDER": "<EMBEDDING_PROVIDER>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"GOOGLE_API_KEY": "<GOOGLE_API_KEY>",
"OLLAMA_URL": "<OLLAMA_URL>",
"EMBEDDING_MODEL": "<EMBEDDING_MODEL>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 12 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"socraticode": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"socraticode"
],
"env": {
"EMBEDDING_PROVIDER": "<EMBEDDING_PROVIDER>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"GOOGLE_API_KEY": "<GOOGLE_API_KEY>",
"OLLAMA_URL": "<OLLAMA_URL>",
"EMBEDDING_MODEL": "<EMBEDDING_MODEL>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 12 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e EMBEDDING_PROVIDER=<EMBEDDING_PROVIDER> -e OPENAI_API_KEY=<OPENAI_API_KEY> -e GOOGLE_API_KEY=<GOOGLE_API_KEY> -e OLLAMA_URL=<OLLAMA_URL> -e EMBEDDING_MODEL=<EMBEDDING_MODEL> socraticode npx -y socraticodeВместо <…> подставьте свои значения. Ещё 12 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Из того же набора2
Похожие
Рядом в теме «Настройка агента: память, контекст, субагенты»
Все MCP-серверы по теме «Настройка агента: память, контекст, субагенты» →Вопросы о socraticode
Как установить socraticode в Claude Code?
Выполните команду `claude mcp add --env EMBEDDING_PROVIDER=<EMBEDDING_PROVIDER> --env OPENAI_API_KEY=<OPENAI_API_KEY> --env GOOGLE_API_KEY=<GOOGLE_API_KEY> --env OLLAMA_URL=<OLLAMA_URL> --env EMBEDDING_MODEL=<EMBEDDING_MODEL> --transport stdio socraticode -- npx -y socraticode`.
Что делает MCP-сервер socraticode?
Он индексирует репозиторий, выполняет поиск по коду и строит граф вызовов между компонентами проекта.
Что нужно для локальной работы сервера?
Требуется среда Node.js версии 18.17 или выше и запущенный Docker для локального контейнера Qdrant.
