Socraticode MCP Server

Your AI reads code. SocratiCode understands it. The open-source codebase context engine: give any AI instant automated knowledge of your entire codebase (and infrastructure) - at scale, zero configuration, fully private, completely free. It runs locally over stdio via the published package.

People connecting coding agent tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-24 · ★ 3,274 · #6 OF 194 MAINTAINED CODING AGENT · VERIFIED 2026-08-25

AGPL-3.0 · TypeScript servers · how we verify → /methodology

01 · Install Socraticode

before you install - you'll need

The README does not document required environment variables for a basic install.

Claude Code

claude mcp add giancarloerra-socraticode -- npx -y socraticode

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "giancarloerra-socraticode": {
      "command": "npx",
      "args": [
        "-y",
        "socraticode"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license AGPL-3.0 - declared in the repository

npm package socraticode - unscoped; check the name against the project README before installing

registry namespace io.github.giancarloerra is GitHub-verified and matches the repo owner

03 · What Socraticode can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v1.12.0 · 2026-08-14

1.12.0 (2026-08-14) · reject backslashes in package: URI paths · resolve Dart package: imports through pubspec-derived package roots (ca7e277), closes #106 · add .dart_tool to the default ignore patterns · refuse Node…

v1.11.0 · 2026-08-05

1.11.0 (2026-08-05) · index Stylus (.styl) files · pin @qdrant/js-client-rest to 1.18.x; restore Node 18 (55d0721), closes qdrant/qdrant-js#134 · fail closed on malformed multipart shard headers (9147ea0), closes #104…

v1.10.0 · 2026-07-30

1.10.0 (2026-07-30) · resolve shell source directives in the file graph · cap before filtering so the empty-chunk invariant actually holds · never emit chunks with empty content · correct the fallback docs and cover…

04 · Who maintains Socraticode

socraticode is maintained by giancarloerra. It's the only MCP server we track from this author; the repo dates to Feb 2026.

05 · Facts

repository
github.com/giancarloerra/socraticode
category
coding agent - ranked #6 of 194 actively-maintained coding agent servers as of 2026-08-25.
release cadence
10+ releases in the last 90 days (latest 2026-08-14)
registry
io.github.giancarloerra/socraticode (active, first published 2026-03-04)
packages
npm:socraticode

06 · Socraticode FAQ

What is Socraticode?

Your AI reads code. SocratiCode understands it. The open-source codebase context engine: give any AI instant automated knowledge of your entire codebase (and infrastructure) - at scale, zero configuration, fully private, completely free. It runs locally over stdio via the published package.

Is Socraticode still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-24 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

How do I install Socraticode?

Run `npx -y socraticode`. The README does not document required environment variables for a basic install. You can also paste the ready-made client config above.

Does Socraticode run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Socraticode

Alternatives to Socraticode

Maintained coding agent servers if Socraticode isn't the fit.

  1. Serena A powerful toolkit for coding, providing semantic retrieval and editing capabilities. ★ 28,461 · 2026-08-20
  2. Desktop Commander MCP server for terminal commands, file operations, and process management ★ 9,387 · 2026-08-21
  3. Ouroboros Pins an acceptance spec; the verify command and expected output never enter the success contract. ★ 5,649 · 2026-08-25
  4. Magic Cloud Self-hosted low-code platform (Docker); its MCP endpoint runs on your own instance, not via npx. ★ 1,180 · 2026-08-24
  5. LLM Sandbox Securely run LLM-generated code in isolated containers across 7 languages and 3 container backends. ★ 1,111 · 2026-08-23
  6. Bernstein (sipyourdrink-ltd) Deterministic orchestrator for CLI coding agents. Byte-identical replay, 40+ adapters, air-gap. ★ 981 · 2026-08-25

Pairs well with

Servers that cover what Socraticode doesn't - only shown when the pairing reason fits the companion.

  1. Context7 → documentation companion documentation · ★ 61,171
  2. GitLab MCP → documentation companion documentation · ★ 1,918
  3. Storybook MCP Addon → developer tools companion developer tools · ★ 268
  4. Xcode Build MCP → developer tools companion developer tools · ★ 6,274
  5. Server Filesystem → filesystem companion filesystem · ★ 38,704
  6. X402 List MCP → filesystem companion filesystem · ★ 58

More coding agent MCP servers · Gjalla · EchoVault Memory · Graph Pilot · Good Memory · Lm

More TypeScript MCP servers · Git Hits · Gitmem · Figma Context MCP · Gnt · Planka · see all