SERVER

Socraticode

Rank #128

io.github.giancarloerra/socraticode

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

4 versions

3,313 GitHub stars

by giancarloerra (2 servers)View repository ↗Claim this server

First listed

Feb 26, 2026

Last publish date

Sep 16, 2026

OVERVIEW

Socraticode is a Model Context Protocol (MCP) server published by giancarloerra. It ranks #128 of 132,113 servers tracked on MCP Toplist, and its repository has 3,313 GitHub stars. Socraticode is listed across 4 registries — Official MCP, Glama, PulseMCP and mcp.so, with 4 tracked versions. It was first listed on Feb 26, 2026 and most recently updated on Sep 16, 2026.

STANDING

#128of 132,113 tracked serversTop 0.1%

Ranks ahead of 131,985 of 132,113 servers on MCP Toplist.

Recent momentum

+1,567GitHub stars since Apr 27 (+90%)

CONNECT

Use Socraticode

No setupRuns out of the box

No credentials or required configuration declared — add it to your MCP client and go.

npm package

claude mcp add socraticode -e "EMBEDDING_PROVIDER=<your EMBEDDING_PROVIDER>" -e "OPENAI_API_KEY=<your OPENAI_API_KEY>" -e "GOOGLE_API_KEY=<your GOOGLE_API_KEY>" -e "OLLAMA_URL=<your OLLAMA_URL>" -e "EMBEDDING_MODEL=<your EMBEDDING_MODEL>" -e "EMBEDDING_DIMENSIONS=<your EMBEDDING_DIMENSIONS>" -e "OLLAMA_MODE=<your OLLAMA_MODE>" -e "OLLAMA_API_KEY=<your OLLAMA_API_KEY>" -e "LMSTUDIO_URL=<your LMSTUDIO_URL>" -e "LMSTUDIO_API_KEY=<your LMSTUDIO_API_KEY>" -e "LMSTUDIO_ALLOW_MISSING_MODEL_LISTING=<your LMSTUDIO_ALLOW_MISSING_MODEL_LISTING>" -e "LITELLM_URL=<your LITELLM_URL>" -e "LITELLM_API_KEY=<your LITELLM_API_KEY>" -e "LITELLM_SEND_DIMENSIONS=<your LITELLM_SEND_DIMENSIONS>" -e "QDRANT_MODE=<your QDRANT_MODE>" -e "QDRANT_URL=<your QDRANT_URL>" -e "QDRANT_API_KEY=<your QDRANT_API_KEY>" -- npx -y socraticode

Replace each placeholder with your own value before saving.

npm package

[mcp_servers.socraticode]
command = "npx"
args = ["-y", "socraticode"]

[mcp_servers.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>"
EMBEDDING_DIMENSIONS = "<your EMBEDDING_DIMENSIONS>"
OLLAMA_MODE = "<your OLLAMA_MODE>"
OLLAMA_API_KEY = "<your OLLAMA_API_KEY>"
LMSTUDIO_URL = "<your LMSTUDIO_URL>"
LMSTUDIO_API_KEY = "<your LMSTUDIO_API_KEY>"
LMSTUDIO_ALLOW_MISSING_MODEL_LISTING = "<your LMSTUDIO_ALLOW_MISSING_MODEL_LISTING>"
LITELLM_URL = "<your LITELLM_URL>"
LITELLM_API_KEY = "<your LITELLM_API_KEY>"
LITELLM_SEND_DIMENSIONS = "<your LITELLM_SEND_DIMENSIONS>"
QDRANT_MODE = "<your QDRANT_MODE>"
QDRANT_URL = "<your QDRANT_URL>"
QDRANT_API_KEY = "<your QDRANT_API_KEY>"

Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.

npm package

{
  "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>",
        "EMBEDDING_DIMENSIONS": "<your EMBEDDING_DIMENSIONS>",
        "OLLAMA_MODE": "<your OLLAMA_MODE>",
        "OLLAMA_API_KEY": "<your OLLAMA_API_KEY>",
        "LMSTUDIO_URL": "<your LMSTUDIO_URL>",
        "LMSTUDIO_API_KEY": "<your LMSTUDIO_API_KEY>",
        "LMSTUDIO_ALLOW_MISSING_MODEL_LISTING": "<your LMSTUDIO_ALLOW_MISSING_MODEL_LISTING>",
        "LITELLM_URL": "<your LITELLM_URL>",
        "LITELLM_API_KEY": "<your LITELLM_API_KEY>",
        "LITELLM_SEND_DIMENSIONS": "<your LITELLM_SEND_DIMENSIONS>",
        "QDRANT_MODE": "<your QDRANT_MODE>",
        "QDRANT_URL": "<your QDRANT_URL>",
        "QDRANT_API_KEY": "<your QDRANT_API_KEY>"
      }
    }
  }
}

Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.

npm package

{
  "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>",
        "EMBEDDING_DIMENSIONS": "<your EMBEDDING_DIMENSIONS>",
        "OLLAMA_MODE": "<your OLLAMA_MODE>",
        "OLLAMA_API_KEY": "<your OLLAMA_API_KEY>",
        "LMSTUDIO_URL": "<your LMSTUDIO_URL>",
        "LMSTUDIO_API_KEY": "<your LMSTUDIO_API_KEY>",
        "LMSTUDIO_ALLOW_MISSING_MODEL_LISTING": "<your LMSTUDIO_ALLOW_MISSING_MODEL_LISTING>",
        "LITELLM_URL": "<your LITELLM_URL>",
        "LITELLM_API_KEY": "<your LITELLM_API_KEY>",
        "LITELLM_SEND_DIMENSIONS": "<your LITELLM_SEND_DIMENSIONS>",
        "QDRANT_MODE": "<your QDRANT_MODE>",
        "QDRANT_URL": "<your QDRANT_URL>",
        "QDRANT_API_KEY": "<your QDRANT_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.

npm package

{
  "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>",
        "EMBEDDING_DIMENSIONS": "<your EMBEDDING_DIMENSIONS>",
        "OLLAMA_MODE": "<your OLLAMA_MODE>",
        "OLLAMA_API_KEY": "<your OLLAMA_API_KEY>",
        "LMSTUDIO_URL": "<your LMSTUDIO_URL>",
        "LMSTUDIO_API_KEY": "<your LMSTUDIO_API_KEY>",
        "LMSTUDIO_ALLOW_MISSING_MODEL_LISTING": "<your LMSTUDIO_ALLOW_MISSING_MODEL_LISTING>",
        "LITELLM_URL": "<your LITELLM_URL>",
        "LITELLM_API_KEY": "<your LITELLM_API_KEY>",
        "LITELLM_SEND_DIMENSIONS": "<your LITELLM_SEND_DIMENSIONS>",
        "QDRANT_MODE": "<your QDRANT_MODE>",
        "QDRANT_URL": "<your QDRANT_URL>",
        "QDRANT_API_KEY": "<your QDRANT_API_KEY>"
      }
    }
  }
}

Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.

npm package

{
  "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>",
        "EMBEDDING_DIMENSIONS": "<your EMBEDDING_DIMENSIONS>",
        "OLLAMA_MODE": "<your OLLAMA_MODE>",
        "OLLAMA_API_KEY": "<your OLLAMA_API_KEY>",
        "LMSTUDIO_URL": "<your LMSTUDIO_URL>",
        "LMSTUDIO_API_KEY": "<your LMSTUDIO_API_KEY>",
        "LMSTUDIO_ALLOW_MISSING_MODEL_LISTING": "<your LMSTUDIO_ALLOW_MISSING_MODEL_LISTING>",
        "LITELLM_URL": "<your LITELLM_URL>",
        "LITELLM_API_KEY": "<your LITELLM_API_KEY>",
        "LITELLM_SEND_DIMENSIONS": "<your LITELLM_SEND_DIMENSIONS>",
        "QDRANT_MODE": "<your QDRANT_MODE>",
        "QDRANT_URL": "<your QDRANT_URL>",
        "QDRANT_API_KEY": "<your QDRANT_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.

npm package

{
  "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>",
        "EMBEDDING_DIMENSIONS": "<your EMBEDDING_DIMENSIONS>",
        "OLLAMA_MODE": "<your OLLAMA_MODE>",
        "OLLAMA_API_KEY": "<your OLLAMA_API_KEY>",
        "LMSTUDIO_URL": "<your LMSTUDIO_URL>",
        "LMSTUDIO_API_KEY": "<your LMSTUDIO_API_KEY>",
        "LMSTUDIO_ALLOW_MISSING_MODEL_LISTING": "<your LMSTUDIO_ALLOW_MISSING_MODEL_LISTING>",
        "LITELLM_URL": "<your LITELLM_URL>",
        "LITELLM_API_KEY": "<your LITELLM_API_KEY>",
        "LITELLM_SEND_DIMENSIONS": "<your LITELLM_SEND_DIMENSIONS>",
        "QDRANT_MODE": "<your QDRANT_MODE>",
        "QDRANT_URL": "<your QDRANT_URL>",
        "QDRANT_API_KEY": "<your QDRANT_API_KEY>"
      }
    }
  }
}

Replace each placeholder with your own value before saving.

BADGE

Show your rank

Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.

Markdown

[![MCP Toplist](https://mcptoplist.com/badge/io.github.giancarloerra%2Fsocraticode.svg)](https://mcptoplist.com/server/io.github.giancarloerra%2Fsocraticode)

HTML

<a href="https://mcptoplist.com/server/io.github.giancarloerra%2Fsocraticode"><img src="https://mcptoplist.com/badge/io.github.giancarloerra%2Fsocraticode.svg" alt="MCP Toplist: Top 1% of 132,113" /></a>

Variants: append ?metric=score or ?metric=stars to the image URL.

REGISTRIES

Listed on 4 registries

ORGANIZATION

giancarloerra

Organization

giancarloerra

Servers in org

Versions across org

Other servers by giancarloerra

Januscope#3,639 · 1 ver

View all giancarloerra servers →

VERSIONS

Available versions (4)

Version	Published
1.14.0	Sep 16, 2026
1.13.3	Sep 10, 2026
1.0.1	Mar 4, 2026
0.1.0	Nov 25, 2024

FAQ

Frequently asked questions

Who maintains Socraticode?: Socraticode is maintained by giancarloerra, which publishes 2 MCP servers (5 total versions) tracked on MCP Toplist.
Is Socraticode listed on the Official MCP Registry?: Yes — Socraticode is listed on the Official MCP Registry, alongside Glama, PulseMCP and mcp.so.
How many versions does Socraticode have?: MCP Toplist tracks 4 versions of Socraticode, most recently published on Sep 16, 2026.
Where can I find the source code for Socraticode?: The source code for Socraticode is hosted at github.com/giancarloerra/socraticode.

Used in projects

Do you run this server?

Add to a project

Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.

EXPLORE

All MCP Servers Official MCP Servers GitHub MCP Servers Best MCP Servers Most Active MCP Servers New MCP Servers Best New MCP Servers