SocratiCode
Enterprise-grade (40m+ LOC) codebase intelligence, zero-setup, local & private Plugin/Skill/Extension or MCP: hybrid semantic search, polyglot dependency graphs, symbol-level impact analysis & call-flow, interactive HTML viewer, cross-project & branch-aware search, DB/API/infra knowledge. 61% less t
SocratiCode is an MCP server that provides deep codebase intelligence for AI assistants through hybrid semantic search, polyglot dependency graphs, and symbol-level impact analysis. It indexes codebases up to 40+ million lines with zero configuration, supports 60+ languages, and runs fully local and private by default using Docker-managed Qdrant and Ollama. The server enables AI agents to understand code architecture, trace call flows, detect blast radius before refactoring, and search across multiple projects simultaneously. It works as a native plugin for Claude Code and OpenAI Codex, or as a direct MCP server for VS Code, Cursor, Zed, Continue, and other MCP-compatible clients.
Key Features
Use Cases
- 01Understanding legacy codebases by searching for architectural patterns and tracing dependency chains
- 02Assessing refactoring impact by analyzing symbol-level blast radius before renaming or deleting functions
- 03Navigating large monorepos with cross-project semantic search across multiple related repositories
- 04Accelerating code review by querying database schemas, API specs, and infrastructure configs alongside source code
- 05Multi-agent collaboration where multiple AI assistants share a single index and work on different parts of the codebase
- 06CI/CD integration with branch-aware indexing to maintain separate indexes per feature branch or pull request
Related MCP Servers
View moremarkitdown
Python tool for converting files and office documents to Markdown.
firecrawl
The context API to search, scrape, and interact with the web at scale. 🔥
prompts.chat
f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.
langflow
Langflow is a powerful tool for building and deploying AI-powered agents and workflows.
SocratiCode — FAQ
What is SocratiCode?+
SocratiCode is an MCP server that provides AI assistants with deep codebase intelligence through hybrid semantic search, polyglot dependency graphs, symbol-level impact analysis, and searchable context artifacts. It indexes codebases up to 40+ million lines with zero configuration and runs fully local and private by default.
How do I install SocratiCode?+
For Claude Code, run 'claude plugin marketplace add giancarloerra/socraticode' then 'claude plugin install --scope user socraticode@socraticode'. For other MCP hosts, add the server config with command 'npx' and args ['-y', '--prefer-online', 'socraticode@latest'] to your MCP configuration file. Docker must be running for the default local setup.
Which AI clients does SocratiCode support?+
SocratiCode works with Claude Code (native plugin), OpenAI Codex (native plugin), VS Code (agent plugin or extension), Cursor (local plugin or direct MCP), Gemini CLI (extension), Continue, Cline, Roo Code, Zed, and OpenCode. It supports any MCP-compatible client via direct stdio configuration.
Does SocratiCode require API keys or cloud services?+
No, the default setup runs fully local using Docker-managed Qdrant and Ollama with no API keys required. Cloud providers (OpenAI embeddings, Google Gemini, Qdrant Cloud) are optional for faster embeddings or remote storage, but never required.
What are the prerequisites?+
Node.js 18.17+ with npx on PATH, and Docker running (for the default local Qdrant and Ollama stack). Docker is optional if you use external Qdrant and native Ollama or cloud embeddings.
Is SocratiCode free?+
Yes, SocratiCode is open source under AGPL-3.0 and free to use. A commercial license is available for organizations that need to use it in proprietary products without AGPL obligations. SocratiCode Cloud is a separate hosted offering currently in private beta.
How do I install SocratiCode?+
Open the source repository on GitHub and follow its README. SocratiCode is a mcp server — MCP Agents Market links you directly to the official repo.
Is SocratiCode free?+
SocratiCode is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.