socraticode
local MCP serversocraticode is a local MCP server: MCP server for enterprise local codebase indexing, semantic search, and code dependency graphs. Install it from npm as socraticode.
Installation
Terminal
claude mcp add socraticode -e EMBEDDING_PROVIDER=... -e OPENAI_API_KEY=... -e GOOGLE_API_KEY=... -e OLLAMA_URL=... -e EMBEDDING_MODEL=... -e EMBEDDING_DIMENSIONS=... -e OLLAMA_MODE=... -e OLLAMA_API_KEY=... -e LMSTUDIO_URL=... -e LMSTUDIO_API_KEY=... -e LMSTUDIO_ALLOW_MISSING_MODEL_LISTING=... -e LITELLM_URL=... -e LITELLM_API_KEY=... -e LITELLM_SEND_DIMENSIONS=... -e QDRANT_MODE=... -e QDRANT_URL=... -e QDRANT_API_KEY=... -- npx -y socraticode
Run in your project folder. Add --scope user to use it everywhere.
Claude Desktop, Cursor & other clients
Add to claude_desktop_config.json or .cursor/mcp.json.
{
"mcpServers": {
"socraticode": {
"command": "npx",
"args": [
"-y",
"socraticode"
],
"env": {
"EMBEDDING_PROVIDER": "...",
"OPENAI_API_KEY": "...",
"GOOGLE_API_KEY": "...",
"OLLAMA_URL": "...",
"EMBEDDING_MODEL": "...",
"EMBEDDING_DIMENSIONS": "...",
"OLLAMA_MODE": "...",
"OLLAMA_API_KEY": "...",
"LMSTUDIO_URL": "...",
"LMSTUDIO_API_KEY": "...",
"LMSTUDIO_ALLOW_MISSING_MODEL_LISTING": "...",
"LITELLM_URL": "...",
"LITELLM_API_KEY": "...",
"LITELLM_SEND_DIMENSIONS": "...",
"QDRANT_MODE": "...",
"QDRANT_URL": "...",
"QDRANT_API_KEY": "..."
}
}
}
}Fill in the environment variables with your own credentials.
What you need
- Runtime: Node.js 18+ (runs with npx).
- MCP client: Claude Code, Codex, Antigravity, Claude Desktop, Cursor or any other client that speaks MCP over stdio.
- Environment variables:
EMBEDDING_PROVIDER,OPENAI_API_KEY,GOOGLE_API_KEY,OLLAMA_URL,EMBEDDING_MODEL,EMBEDDING_DIMENSIONS,OLLAMA_MODE,OLLAMA_API_KEY,LMSTUDIO_URL,LMSTUDIO_API_KEY,LMSTUDIO_ALLOW_MISSING_MODEL_LISTING,LITELLM_URL,LITELLM_API_KEY,LITELLM_SEND_DIMENSIONS,QDRANT_MODE,QDRANT_URL,QDRANT_API_KEY
Summary
MCP server for enterprise local codebase indexing, semantic search, and code dependency graphs.
socraticode vs similar servers
| Server | Stars | Type | API key | Runtime |
|---|---|---|---|---|
| socraticode | 3,322 | Local | Yes | npm |
| arxiv-mcp-server | 3,177 | Local | Yes | pypi |
| Firecrawl MCP Server | 7,526 | Local | Yes | npm |
| brave | 1,477 | Hosted | Yes | None |
| Octocode | 478 | Local | No | npm |
Questions
It reads 17 environment variables: EMBEDDING_PROVIDER, OPENAI_API_KEY, GOOGLE_API_KEY, OLLAMA_URL, EMBEDDING_MODEL, EMBEDDING_DIMENSIONS, OLLAMA_MODE, OLLAMA_API_KEY, LMSTUDIO_URL, LMSTUDIO_API_KEY, LMSTUDIO_ALLOW_MISSING_MODEL_LISTING, LITELLM_URL, LITELLM_API_KEY, LITELLM_SEND_DIMENSIONS, QDRANT_MODE, QDRANT_URL, QDRANT_API_KEY. Set them in your MCP config before starting the server.
Node.js 18+ (runs with npx), plus an MCP client such as Claude Code, Codex, Claude Desktop or Cursor.
socraticode is a local MCP server distributed as the npm package socraticode.
Run: claude mcp add socraticode -e EMBEDDING_PROVIDER=... -e OPENAI_API_KEY=... -e GOOGLE_API_KEY=... -e OLLAMA_URL=... -e EMBEDDING_MODEL=... -e EMBEDDING_DIMENSIONS=... -e OLLAMA_MODE=... -e OLLAMA_API_KEY=... -e LMSTUDIO_URL=... -e LMSTUDIO_API_KEY=... -e LMSTUDIO_ALLOW_MISSING_MODEL_LISTING=... -e LITELLM_URL=... -e LITELLM_API_KEY=... -e LITELLM_SEND_DIMENSIONS=... -e QDRANT_MODE=... -e QDRANT_URL=... -e QDRANT_API_KEY=... -- npx -y socraticode
Run: codex mcp add socraticode --env EMBEDDING_PROVIDER=... --env OPENAI_API_KEY=... --env GOOGLE_API_KEY=... --env OLLAMA_URL=... --env EMBEDDING_MODEL=... --env EMBEDDING_DIMENSIONS=... --env OLLAMA_MODE=... --env OLLAMA_API_KEY=... --env LMSTUDIO_URL=... --env LMSTUDIO_API_KEY=... --env LMSTUDIO_ALLOW_MISSING_MODEL_LISTING=... --env LITELLM_URL=... --env LITELLM_API_KEY=... --env LITELLM_SEND_DIMENSIONS=... --env QDRANT_MODE=... --env QDRANT_URL=... --env QDRANT_API_KEY=... -- npx -y socraticode
Similar MCP servers
NameStars
- arxiv-mcp-serverio.github.blazickjp/arxiv-mcp-server3,177
- Firecrawl MCP Serverio.github.firecrawl/firecrawl-mcp-server7,526
- braveai.smithery/brave1,477
- Octocodeio.github.Muvon/octocode478
- marm-mcp-serverio.github.Lyellr88/marm-mcp-server406
- mcp-documentation-serverio.github.andrea9293/mcp-documentation-server342
- shodh-memoryio.github.varun29ankuS/shodh-memory294
- mcp-sap-docsio.github.marianfoo/mcp-sap-docs233