SocratiCode is a fairly comprehensive local codebase-intelligence MCP server offering hybrid semantic search, polyglot dependency graphs, and symbol-level impact analysis, running by default in local Docker containers with no API key required — well suited for deep exploration of large, multi-language repositories. Adopting it means accepting locally-run Docker containers, optional cloud API keys for alternate embedding providers, and AGPL-3.0 licensing terms; the documentation is explicit that its static-analysis call graph has blind spots around dynamic dispatch and framework magic, so impact-analysis results should be paired with manual review.
SocratiCode is an open-source MCP server that gives AI assistants deep semantic understanding of a codebase. It runs hybrid semantic + BM25 (RRF-fused) search on top of Qdrant (vector database) and Ollama (local embeddings by default, switchable to OpenAI or Google), uses ast-grep for AST-aware chunking across 18+ languages, and builds a polyglot dependency graph with symbol-level impact analysis (blast radius), call-flow tracing, circular-dependency detection, and an interactive HTML graph viewer. It also supports cross-project and branch-aware search, and indexing of non-code knowledge such as database schemas, API specs, and infra configs. The README reports, from a benchmark on VS Code's 2.45M-line codebase, 61% less context, 84% fewer tool calls, and 37x faster responses versus grep-based exploration. By default everything runs locally via Docker with no API keys required and no code leaving the machine; cloud embedding providers and external Qdrant instances are optional. The project is licensed under AGPL-3.0 and also offers a separate paid cloud offering (SocratiCode Cloud) currently in private beta.
1) Make sure Docker is installed and running, and Node.js 18+ is available. 2) Simplest route: add the npx launch command to your MCP client config — {"command":"npx","args":["-y","socraticode"]} under mcpServers (Claude Desktop, Windsurf, Cline, Roo Code) or servers (VS Code project-local .vscode/mcp.json). 3) Claude Code users are recommended to install the official plugin, which bundles workflow skills: run claude plugin marketplace add giancarloerra/socraticode then claude plugin install socraticode@socraticode (or the equivalent /plugin marketplace add and /plugin install slash commands inside Claude Code). 4) VS Code/Cursor users can also install the dedicated extension/plugin from the VS Code Marketplace, Open VSX, or Cursor Marketplace. 5) On first use the server automatically pulls Docker images and starts Qdrant and Ollama containers and downloads the embedding model — a one-time step taking roughly 5 minutes; subsequent starts take seconds. 6) For cloud embeddings (OpenAI/Google) or an external Qdrant instance, set env vars such as EMBEDDING_PROVIDER, OPENAI_API_KEY, GOOGLE_API_KEY, QDRANT_MODE, QDRANT_URL, and QDRANT_API_KEY in the client config. 7) On a project for the first time, ask the AI to 'index this codebase' to trigger codebase_index, then check progress with codebase_status.
{"mcpServers":{"socraticode":{"command":"npx","args":["-y","socraticode"]}}}