socraticode

MCP server for local codebase indexing, semantic search, and code dependency graphs.

stdio v1.0.1

Connection Configuration

Add this to your AI agent's MCP config file to connect.

Run in your terminal:

claude mcp add io.github.giancarloerra--socraticode -- npx

Transport

stdio

Authentication

None

Version

v1.0.1

Server Name

io.github.giancarloerra/socraticode

Last Updated

Mar 4, 2026

How to install and connect this MCP server.

Environment variables you must provide when running this server.

Variable	Description	Required
`EMBEDDING_PROVIDER`	Embedding provider to use: ollama (default), openai, or google	Optional
`OPENAI_API_KEY` secret	API key for OpenAI embeddings (required only when EMBEDDING_PROVIDER=openai)	Optional
`GOOGLE_API_KEY` secret	API key for Google embeddings (required only when EMBEDDING_PROVIDER=google)	Optional
`OLLAMA_URL`	URL of the Ollama server (default: auto-detected; Docker-managed or http://localhost:11434)	Optional
`EMBEDDING_MODEL`	Embedding model name (defaults per provider: nomic-embed-text for ollama, text-embedding-3-small for openai, gemini-embedding-001 for google)	Optional
`QDRANT_MODE`	Qdrant mode: managed (default, Docker-managed) or external (user-provided instance)	Optional
`QDRANT_URL`	Full URL for remote/cloud Qdrant (e.g. https://xyz.cloud.qdrant.io:6333). Only needed when QDRANT_MODE=external	Optional
`QDRANT_API_KEY` secret	API key for remote Qdrant instance. Only needed when QDRANT_MODE=external	Optional