SocratiCode

Name: SocratiCode
Author: giancarloerra

giancarloerra

Local, private codebase intelligence for agents: hybrid semantic search, polyglot dependency graphs and symbol-level impact analysis.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add socraticode --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env GOOGLE_API_KEY='<GOOGLE_API_KEY>' --env OLLAMA_API_KEY='<OLLAMA_API_KEY>' --env LMSTUDIO_API_KEY='<LMSTUDIO_API_KEY>' --env LITELLM_API_KEY='<LITELLM_API_KEY>' --env QDRANT_API_KEY='<QDRANT_API_KEY>' -- npx -y socraticode

~/.codex/config.toml

[mcp_servers.socraticode]
command = "npx"
args = ["-y", "socraticode"]
env = { OPENAI_API_KEY = "<OPENAI_API_KEY>", GOOGLE_API_KEY = "<GOOGLE_API_KEY>", OLLAMA_API_KEY = "<OLLAMA_API_KEY>", LMSTUDIO_API_KEY = "<LMSTUDIO_API_KEY>", LITELLM_API_KEY = "<LITELLM_API_KEY>", QDRANT_API_KEY = "<QDRANT_API_KEY>" }

# codex mcp add socraticode --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env GOOGLE_API_KEY='<GOOGLE_API_KEY>' --env OLLAMA_API_KEY='<OLLAMA_API_KEY>' --env LMSTUDIO_API_KEY='<LMSTUDIO_API_KEY>' --env LITELLM_API_KEY='<LITELLM_API_KEY>' --env QDRANT_API_KEY='<QDRANT_API_KEY>' -- npx -y socraticode

~/.cursor/mcp.json

{
  "mcpServers": {
    "socraticode": {
      "command": "npx",
      "args": [
        "-y",
        "socraticode"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "GOOGLE_API_KEY": "<GOOGLE_API_KEY>",
        "OLLAMA_API_KEY": "<OLLAMA_API_KEY>",
        "LMSTUDIO_API_KEY": "<LMSTUDIO_API_KEY>",
        "LITELLM_API_KEY": "<LITELLM_API_KEY>",
        "QDRANT_API_KEY": "<QDRANT_API_KEY>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "socraticode": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "socraticode"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "GOOGLE_API_KEY": "<GOOGLE_API_KEY>",
        "OLLAMA_API_KEY": "<OLLAMA_API_KEY>",
        "LMSTUDIO_API_KEY": "<LMSTUDIO_API_KEY>",
        "LITELLM_API_KEY": "<LITELLM_API_KEY>",
        "QDRANT_API_KEY": "<QDRANT_API_KEY>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "socraticode": {
      "command": "npx",
      "args": [
        "-y",
        "socraticode"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "GOOGLE_API_KEY": "<GOOGLE_API_KEY>",
        "OLLAMA_API_KEY": "<OLLAMA_API_KEY>",
        "LMSTUDIO_API_KEY": "<LMSTUDIO_API_KEY>",
        "LITELLM_API_KEY": "<LITELLM_API_KEY>",
        "QDRANT_API_KEY": "<QDRANT_API_KEY>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "socraticode": {
      "command": "npx",
      "args": [
        "-y",
        "socraticode"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "GOOGLE_API_KEY": "<GOOGLE_API_KEY>",
        "OLLAMA_API_KEY": "<OLLAMA_API_KEY>",
        "LMSTUDIO_API_KEY": "<LMSTUDIO_API_KEY>",
        "LITELLM_API_KEY": "<LITELLM_API_KEY>",
        "QDRANT_API_KEY": "<QDRANT_API_KEY>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "socraticode": {
      "command": "npx",
      "args": [
        "-y",
        "socraticode"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "GOOGLE_API_KEY": "<GOOGLE_API_KEY>",
        "OLLAMA_API_KEY": "<OLLAMA_API_KEY>",
        "LMSTUDIO_API_KEY": "<LMSTUDIO_API_KEY>",
        "LITELLM_API_KEY": "<LITELLM_API_KEY>",
        "QDRANT_API_KEY": "<QDRANT_API_KEY>"
      }
    }
  }
}

Environment variables

OPENAI_API_KEY
GOOGLE_API_KEY
OLLAMA_API_KEY
LMSTUDIO_API_KEY
LITELLM_API_KEY
QDRANT_API_KEY

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related