MCP server for local codebase indexing, semantic search, and code dependency graphs.
Connect Socraticode to Claude, Cursor or any other MCP client and it stops being a tab you switch to. MCP server for local codebase indexing, semantic search, and code dependency graphs. The socraticode mcp server is what makes that connection.
The first Qdrant‑based MCP/Claude Plugin/Skill that pairs auto‑managed, zero‑config local Docker deployment with AST‑aware code chunking, hybrid semantic + BM25 (RRF‑fused) code search, polyglot dependency graphs with circular‑dependency visualisation, symbol‑level Impact Analysis (blast‑radius & call‑flow tracing across 18 languages), and searchable infra/API/database artifacts in a single focused, zero-config and easy to use code intelligence engine.
The toolset is worth reading before you wire it up, because it tells you what the integration is really for:
Multi — provider embeddings** — Switch between Local Ollama (private, GPU access), Docker Ollama (zero-config), OpenAI (text-embedding-3-small, fastest)AST — aware chunking** — Files are split at function/class boundaries using AST parsing (ast-grep), not arbitrary line counts. This produces higher-qualityLanguage-agnostic — Works with every programming language, framework, and file type out of the box. No per-language parsers to install, no grammar files to maintain, noMulti-project — Index multiple projects simultaneously. Each gets its own isolated collection with full project path trackingCross — project search** — Search across multiple related projects in a single query. Link projects via .socraticode.json or the SOCRATICODE_LINKED_PROJECTSBranch — aware indexing** — Maintain separate indexes per git branch by setting SOCRATICODE_BRANCH_AWARE=true. Each branch gets its own Qdrant collections, soPlatform — Install methodCursor — /add-plugin https://github.com/giancarloerra/socraticode (plugin format with skills). Also listed in the Cursor Marketplace atZed — Add as a custom MCP server in Zed settings — config exampleFeature — Claude CodeBecause this one is hosted, setup is mostly authentication — you point your client at the endpoint and approve access. Nothing runs on your machine, so there is no runtime to keep patched.
Configuration is passed through the environment: QDRANT_URL, QDRANT_API_KEY, OLLAMA_URL. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
This sits in the AI and media services group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Socraticode's toolset — Multi, AST, Language-agnostic and 7 more — is a fair guide to whether it matches your workflow. It is maintained by giancarloerra; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Socraticode's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| Multi | provider embeddings** — Switch between Local Ollama (private, GPU access), Docker Ollama (zero-config), OpenAI (text-embedding-3-small, fastest), Google Gemini (gemini-embedding-001, free tier), LM Studio (local OpenAI-c |
| AST | aware chunking** — Files are split at function/class boundaries using AST parsing (ast-grep), not arbitrary line counts. This produces higher-quality search results. Falls back to line-based chunking for unsupported lang |
| Language-agnostic | Works with every programming language, framework, and file type out of the box. No per-language parsers to install, no grammar files to maintain, no "unsupported language" limitations. If your AI can read it, SocratiCode |
| Multi-project | Index multiple projects simultaneously. Each gets its own isolated collection with full project path tracking. |
| Cross | project search** — Search across multiple related projects in a single query. Link projects via .socraticode.json or the SOCRATICODE_LINKED_PROJECTS env var, then set includeLinked: true on codebase_search. Results are t |
| Branch | aware indexing** — Maintain separate indexes per git branch by setting SOCRATICODE_BRANCH_AWARE=true. Each branch gets its own Qdrant collections, so switching branches instantly switches to the correct index. Ideal for |
| Platform | Install method |
| Cursor | /add-plugin https://github.com/giancarloerra/socraticode (plugin format with skills). Also listed in the Cursor Marketplace at [cursor.com/marketplace](https://cursor.com/marketplace). |
| Zed | Add as a custom MCP server in Zed settings — [config example](#zed) |
| Feature | Claude Code |
{
"mcpServers": {
"socraticode": {
"command": "npx",
"args": ["-y", "socraticode"],
"env": {
"QDRANT_URL": "your-value",
"QDRANT_API_KEY": "your-value",
"OLLAMA_URL": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
| Variable | Description | Required |
|---|---|---|
| QDRANT_URL | Endpoint or connection string the server talks to. | Yes |
| QDRANT_API_KEY | Credential the server authenticates with. | Yes |
| OLLAMA_URL | Endpoint or connection string the server talks to. | Yes |
Build a programmable telecommunications stack for connecting telephony services with the Internet via a cloud-based utility.
Search built for AI, not humans — semantic web search that returns model-ready content, plus code context.
Answers, not links — delegate questions to Perplexity's search-grounded models and get cited responses back.
Give your assistant a voice — text-to-speech, voice cloning and audio tools from the ElevenLabs API.
Give your assistant a real code sandbox — isolated cloud VMs for actually running the code it writes.
The ML hub in your context window — search models, datasets, papers and run Spaces from the official server.