SERVER

Socraticode

Rank #349

io.github.giancarloerra/socraticode

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

7 versions

3,363 GitHub stars

by giancarloerra (2 servers)View repository ↗

First listed

Feb 26, 2026

Last publish date

Oct 15, 2026

PURPOSE

What you can do with Socraticode

Socraticode is a Model Context Protocol (MCP) server published by giancarloerra. It ranks #349 of 167,945 active servers on MCP Toplist, and its repository has 3,363 GitHub stars. Socraticode is listed across 4 registries — Official MCP, Glama, PulseMCP and mcp.so, with 7 tracked versions. It was first listed on Feb 26, 2026 and most recently updated on Oct 15, 2026.

Not verifiedMCP Toplist has not yet written a checked profile for this server, so the paragraph above is assembled from registry data only. The repository README is the authority on what it does.

CAPABILITIES AND LIMITATIONS

What Socraticode can and cannot do

Not verifiedMCP Toplist has not catalogued this server's tools or limitations. The repository README lists them.

REQUIREMENTS

What you need before using Socraticode

DeclaredNo credentialsNo credentials declared

The registry listing declares no required environment variables or authentication. This is declared metadata, not a verified install — the repository README is the authority.

Declared by Glama, last synced Nov 3, 2026. Not independently verified by MCP Toplist.

Declared in the registry install config

EMBEDDING_PROVIDER · optional
OPENAI_API_KEY · optional
GOOGLE_API_KEY · optional
OLLAMA_URL · optional
EMBEDDING_MODEL · optional
EMBEDDING_DIMENSIONS · optional
OLLAMA_MODE · optional
OLLAMA_API_KEY · optional
LMSTUDIO_URL · optional
LMSTUDIO_API_KEY · optional
LMSTUDIO_ALLOW_MISSING_MODEL_LISTING · optional
LITELLM_URL · optional
LITELLM_API_KEY · optional
LITELLM_SEND_DIMENSIONS · optional
QDRANT_MODE · optional
QDRANT_URL · optional
QDRANT_API_KEY · optional

INSTALLATION AND FIRST TASK

Connect Socraticode and confirm it works

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.

First successful task

After adding the config, ask your client to list this server's tools. A tool list confirms the connection; an empty list or an error means the server did not start or needs credentials.

ALTERNATIVES

When to choose another server

Other servers by giancarloerra

Januscope#6,919

View all giancarloerra servers →

No task-specific alternatives are catalogued for Socraticodeyet; the list above is its publisher's other servers.

MAINTENANCE AND EVIDENCE

What changed, and when this was checked

First listed: Feb 26, 2026
Latest version published: Oct 15, 2026
Version history: 7 versions tracked (below)
Requirements evidence: Declared by Glama, last synced Nov 3, 2026. Not independently verified by MCP Toplist.
Profile checked: Not yet — purpose, capabilities and requirements above come from registry data only
Ranking data as of: Nov 3, 2026

Registry sightings

Official MCP ↗listed since Apr 25, 2026 · still listed
Glama ↗listed since May 4, 2026 · still listed
PulseMCP ↗listed since May 22, 2026 · still listed
mcp.so ↗listed since May 23, 2026 · still listed

Do you maintain Socraticode? to correct or enrich this profile.

VERSIONS

Available versions (7)

Version	Published
1.16.1	Oct 15, 2026
1.16.0	Sep 28, 2026
1.15.0	Sep 24, 2026
1.14.0	Sep 16, 2026
1.13.3	Sep 10, 2026
1.0.1	Mar 4, 2026
0.1.0	Nov 25, 2024

STANDING

#349of 167,945 active serversTop 0.5%

Ranks ahead of 167,596 of 167,945 servers on MCP Toplist.

Recent momentum

+1,617GitHub stars since Apr 27 (+93%)

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 167,945" /></a>

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

FAQ

Frequently asked questions

Who maintains Socraticode?: Socraticode is maintained by giancarloerra, which publishes 2 MCP servers (8 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 7 versions of Socraticode, most recently published on Oct 15, 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?

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