← Index

io.github.giancarloerra/socraticode

io.github.giancarloerra/socraticode·v1.0.1·Search
Quality Score
83
/100

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

§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "socraticode": {
      "command": "npx",
      "args": [
        "-y",
        "socraticode"
      ],
      "env": {
        "EMBEDDING_PROVIDER": "<embedding_provider>",
        "OPENAI_API_KEY": "<your-openai_api_key>",
        "GOOGLE_API_KEY": "<your-google_api_key>",
        "OLLAMA_URL": "<ollama_url>",
        "EMBEDDING_MODEL": "<embedding_model>",
        "QDRANT_MODE": "<qdrant_mode>",
        "QDRANT_URL": "<qdrant_url>",
        "QDRANT_API_KEY": "<your-qdrant_api_key>"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "socraticode": {
      "command": "npx",
      "args": [
        "-y",
        "socraticode"
      ],
      "env": {
        "EMBEDDING_PROVIDER": "<embedding_provider>",
        "OPENAI_API_KEY": "<your-openai_api_key>",
        "GOOGLE_API_KEY": "<your-google_api_key>",
        "OLLAMA_URL": "<ollama_url>",
        "EMBEDDING_MODEL": "<embedding_model>",
        "QDRANT_MODE": "<qdrant_mode>",
        "QDRANT_URL": "<qdrant_url>",
        "QDRANT_API_KEY": "<your-qdrant_api_key>"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y socraticode
§02  Environment variables
EMBEDDING_PROVIDER

Embedding provider to use: ollama (default), openai, or google

OPENAI_API_KEY
secret

API key for OpenAI embeddings (required only when EMBEDDING_PROVIDER=openai)

GOOGLE_API_KEY
secret

API key for Google embeddings (required only when EMBEDDING_PROVIDER=google)

OLLAMA_URL

URL of the Ollama server (default: auto-detected; Docker-managed or http://localhost:11434)

EMBEDDING_MODEL

Embedding model name (defaults per provider: nomic-embed-text for ollama, text-embedding-3-small for openai, gemini-embedding-001 for google)

QDRANT_MODE

Qdrant mode: managed (default, Docker-managed) or external (user-provided instance)

QDRANT_URL

Full URL for remote/cloud Qdrant (e.g. https://xyz.cloud.qdrant.io:6333). Only needed when QDRANT_MODE=external

QDRANT_API_KEY
secret

API key for remote Qdrant instance. Only needed when QDRANT_MODE=external

§03  MCP Quality Score  ·  methodology
freshness
23
completeness
10
installability
25
documentation
15
stability
10
§04  Alternatives in Search