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 who work with ai assistant, embeddings and semantic and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-28 · ★ 3,327 · #5 OF 250 MAINTAINED CODING AGENT · VERIFIED 2026-09-30

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

01 · Install Socraticode

before you install - you'll need

Set EMBEDDING_PROVIDER, OPENAI_API_KEY, SOCRATICODE_SPEC, QDRANT_MODE, QDRANT_URL before connecting.

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.16.0 · 2026-09-28

1.16.0 (2026-09-28) · add opt-in Git-triggered refresh · preserve Git refresh startup state · wait for Git refresh deletions to complete · add quick setup and scenario guides · clarify editor setup steps · clarify VS…

v1.15.0 · 2026-09-24

1.15.0 (2026-09-24) · allow the Claude Code plugin engine specification to be pinned (0c33776), closes #149 · read PHP typed property declarations as type references · apply a PHP use alias only below the use that…

v1.14.0 · 2026-09-16

1.14.0 (2026-09-16) · support configured Python import roots · reclaim stored identities explicitly · keep the resolver documented, and only advise what is true · treat an unusable branch name as no branch, and unsign…

04 · Who maintains Socraticode

socraticode is maintained by giancarloerra. We track 2 MCP servers from giancarloerra - 2 actively maintained, 3,358 combined GitHub stars, oldest repo from Feb 2026. Full record: all servers from giancarloerra.

januscope Local MCP proxy for tool restrictions, response redaction, audit logs, and database schema context. ★ 31

05 · Facts

repository: github.com/giancarloerra/socraticode
category: coding agent - ranked #5 of 250 actively-maintained coding agent servers as of 2026-09-30.
release cadence: 10+ releases in the last 90 days (latest 2026-09-28)
registry: io.github.giancarloerra/socraticode (active, first published 2026-03-04 · 5 versions)
packages: npm:socraticode

06 · Socraticode FAQ

What is Socraticode?

Is Socraticode still maintained?

Yes - as of 2026-09-30, its last commit was 2026-09-28 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 documents 5 environment variables (EMBEDDING_PROVIDER, OPENAI_API_KEY, SOCRATICODE_SPEC…) to set first. Set EMBEDDING_PROVIDER, OPENAI_API_KEY, SOCRATICODE_SPEC, QDRANT_MODE, QDRANT_URL before connecting. 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.

Pairs well with

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

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

More TypeScript MCP servers · Git Hits · Gitmem · Glbforge · Figma Context MCP (glips) · see all