MCP Server

io.github.giancarloerra/socraticode MCP Server

Name: io.github.giancarloerra/socraticode MCP Server
Author: io.github.giancarloerra

io.github.giancarloerra/socraticode

Repository Registry

What is the io.github.giancarloerra/socraticode MCP server?

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

How to install io.github.giancarloerra/socraticode

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

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

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "socraticode": {
      "command": "npx",
      "args": [
        "-y",
        "socraticode"
      ],
      "env": {
        "EMBEDDING_PROVIDER": "<YOUR_EMBEDDING_PROVIDER>",
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "GOOGLE_API_KEY": "<YOUR_GOOGLE_API_KEY>",
        "OLLAMA_URL": "<YOUR_OLLAMA_URL>",
        "EMBEDDING_MODEL": "<YOUR_EMBEDDING_MODEL>",
        "QDRANT_MODE": "<YOUR_QDRANT_MODE>",
        "QDRANT_URL": "<YOUR_QDRANT_URL>",
        "QDRANT_API_KEY": "<YOUR_QDRANT_API_KEY>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "socraticode": {
      "command": "npx",
      "args": [
        "-y",
        "socraticode"
      ],
      "env": {
        "EMBEDDING_PROVIDER": "<YOUR_EMBEDDING_PROVIDER>",
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "GOOGLE_API_KEY": "<YOUR_GOOGLE_API_KEY>",
        "OLLAMA_URL": "<YOUR_OLLAMA_URL>",
        "EMBEDDING_MODEL": "<YOUR_EMBEDDING_MODEL>",
        "QDRANT_MODE": "<YOUR_QDRANT_MODE>",
        "QDRANT_URL": "<YOUR_QDRANT_URL>",
        "QDRANT_API_KEY": "<YOUR_QDRANT_API_KEY>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "socraticode": {
      "command": "npx",
      "args": [
        "-y",
        "socraticode"
      ],
      "env": {
        "EMBEDDING_PROVIDER": "<YOUR_EMBEDDING_PROVIDER>",
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "GOOGLE_API_KEY": "<YOUR_GOOGLE_API_KEY>",
        "OLLAMA_URL": "<YOUR_OLLAMA_URL>",
        "EMBEDDING_MODEL": "<YOUR_EMBEDDING_MODEL>",
        "QDRANT_MODE": "<YOUR_QDRANT_MODE>",
        "QDRANT_URL": "<YOUR_QDRANT_URL>",
        "QDRANT_API_KEY": "<YOUR_QDRANT_API_KEY>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "socraticode": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "socraticode"
      ],
      "env": {
        "EMBEDDING_PROVIDER": "<YOUR_EMBEDDING_PROVIDER>",
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "GOOGLE_API_KEY": "<YOUR_GOOGLE_API_KEY>",
        "OLLAMA_URL": "<YOUR_OLLAMA_URL>",
        "EMBEDDING_MODEL": "<YOUR_EMBEDDING_MODEL>",
        "QDRANT_MODE": "<YOUR_QDRANT_MODE>",
        "QDRANT_URL": "<YOUR_QDRANT_URL>",
        "QDRANT_API_KEY": "<YOUR_QDRANT_API_KEY>"
      }
    }
  }
}

Claude Code

claude mcp add socraticode --env EMBEDDING_PROVIDER=<YOUR_EMBEDDING_PROVIDER> --env OPENAI_API_KEY=<YOUR_OPENAI_API_KEY> --env GOOGLE_API_KEY=<YOUR_GOOGLE_API_KEY> --env OLLAMA_URL=<YOUR_OLLAMA_URL> --env EMBEDDING_MODEL=<YOUR_EMBEDDING_MODEL> --env QDRANT_MODE=<YOUR_QDRANT_MODE> --env QDRANT_URL=<YOUR_QDRANT_URL> --env QDRANT_API_KEY=<YOUR_QDRANT_API_KEY> -- npx -y socraticode