Socraticode
Index your repo locally so agents can semantically search code and explore dependency graphs without sending the whole codebase to a cloud indexer.
Overview
Socraticode is a MCP server for the Build phase that provides local codebase indexing, semantic search, and dependency graphs for agent tooling.
What is this MCP server?
- Local codebase indexing with semantic search over your repository
- Code dependency graph tooling for navigation and impact analysis
- stdio npm package socraticode v1.0.1
- Embedding providers: ollama (default), openai, or google via EMBEDDING_PROVIDER
- Configurable OLLAMA_URL, EMBEDDING_MODEL, and provider API keys
- 3 embedding provider options documented: ollama, openai, google
- Published package version 1.0.1 in server.json
- stdio transport via npm registry identifier socraticode
Community signal: 2.9k GitHub stars.
What problem does it solve?
Agents lose context on large repos when search is limited to open files and string grep, which slows refactors and reviews.
Who is it for?
Solo developers who want private, local semantic code search and graph navigation inside Claude Code or Cursor without a SaaS code intelligence vendor.
Skip if: Builders who only edit single-file scripts, refuse local GPU/Ollama setup, or need Google Docs or ticket-system MCP instead of repo intelligence.
What do I get? / Deliverables
After install and indexing, your agent queries semantic chunks and dependency graphs locally with your chosen embedding provider.
- Local semantic search index over your codebase
- MCP-accessible dependency graph views for agent-driven navigation
Recommended MCP Servers
Journey fit
Codebase indexing is adopted when you equip the agent during Build, but the same index supports review and iteration later. agent-tooling is the canonical shelf because semantic search and dependency graphs exist to make MCP agents effective on your tree.
How it compares
Local developer-tools MCP for repo intelligence, not a finance swap or marketing API server.
Common Questions / FAQ
Who is Socraticode for?
Socraticode is for indie builders and small teams who want MCP-driven semantic search and dependency graphs on their own machine with optional Ollama, OpenAI, or Google embeddings.
When should I use Socraticode?
Use it when you start relying on an agent for multi-package refactors, onboarding to an unfamiliar repo, or review prep and need durable local search.
How do I add Socraticode to my agent?
Install the npm package socraticode, set EMBEDDING_PROVIDER and any OPENAI_API_KEY, GOOGLE_API_KEY, or OLLAMA_URL values, then register the stdio MCP server in your client config.