socraticode

socraticode

giancarloerraAGPL-3.0
2.8k звёзд371 форков
SocratiCode — MCP-сервер, который индексирует локальную кодовую базу и даёт AI-ассистентам понимание кода. Он ищет код по смыслу, показывает, как связаны модули, и открывает нужные файлы в редакторе. Вы задаёте вопрос на естественном языке — ассистент находит ответ прямо в вашем проекте. Сервер пригодится разработчикам, которые работают с большими проектами на нескольких языках. Вместо того чтобы вручную искать функции или классы, можно просто спросить AI: «Найди все места, где вызывается этот метод» или «Покажи, от чего зависит этот файл». SocratiCode индексирует проект один раз, а затем обрабатывает запросы через MCP. Сервер использует встраивания (embeddings) для точного семантического поиска и поддерживает основные языки: TypeScript, JavaScript, Python, Java, Go, Rust.
DevelopmentSearch
Открыть на GitHub

Установка

npx -y socraticode

Характеристики

Общее

  • СтатусСообщество
  • Разработчикgiancarloerra
  • ЛицензияAGPL-3.0

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Индексирует код проекта и строит семантическую карту, по которой можно искать смысл, а не только точное совпадение строк.
  • Выполняет семантический поиск по коду на естественном языке: «найди функцию, которая парсит CSV» — и AI показывает результат.
  • Строит граф зависимостей — показывает, какие файлы и модули связаны между собой.
  • Открывает найденные файлы в редакторе (VS Code, Cursor) одной командой.
  • Работает как плагин для Claude Code (рекомендовано) — расширяет возможности AI при анализе кода.
  • Доступен в виде расширения для VS Code в Marketplace.
  • Совместим с любыми MCP-клиентами: Claude Desktop, Cursor, VS Code Insiders и другими.
  • Поддерживает Node.js 18+ и автоматически исключает файлы из .gitignore.

Как подключить

  • 1. Установите Node.js версии 18 или выше.
  • 2. Добавьте сервер в конфигурацию вашего MCP-клиента. Для Claude Desktop отредактируйте файл конфигурации (обычно ~/Library/Application Support/Claude/claude_desktop_config.json) и добавьте в секцию «mcpServers»:

{"mcpServers":{"socraticode":{"command":"npx","args":["-y","socraticode"]}}}

  • 3. Перезапустите Claude Desktop. Сервер запустится автоматически при запросе к AI. Если вы используете VS Code, установите расширение «SocratiCode» из Marketplace или добавьте сервер вручную через конфигурацию MCP.

Примеры запросов

  • «Найди в проекте все функции, которые работают с авторизацией пользователя.»
  • «Покажи граф зависимостей для файла src/services/auth.ts.»
  • «Открой файл, в котором определён класс DatabaseConnection.»
  • «Найди, какие модули используют устаревшую функцию processData.»

Технические детали

Язык: TypeScript. Транспорт: stdio (MCP). Лицензия: AGPL-3.0 (открытый исходный код). Совместимые клиенты: Claude Desktop, Claude Code, VS Code, Cursor, любой MCP-клиент. Требования: Node.js ≥ 18. Дополнительно: использует embeddings для семантического поиска, индекс кэшируется для ускорения повторных запросов, поддерживается работа с несколькими репозиториями.

Поделиться