Skip to content
Agentmart
Submit a tool

Socraticode

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

Connector by giancarloerra · GitHub account verified by the MCP Registry

IndexedAGPL-3.0Local (stdio)★ 3,354
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/giancarloerra-socraticode

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

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

Use cases: refactoring, code-review

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
13 read · 4 write · 4 delete · 5 not yet classified
Secrets
6 (API keys, tokens or passwords)
Install scripts
Not scanned yet
Runs as
Node.js package

Tools by what they do 26

Read from the source code; the running server may list different tools.

Read 13 · Look things up without changing anything.

  • codebase_context
  • codebase_context_search
  • codebase_graph_circular
  • codebase_graph_query
  • codebase_graph_stats
  • codebase_graph_status
  • codebase_graph_visualize
  • codebase_health
  • codebase_list_projects
  • codebase_search
  • codebase_status
  • codebase_symbol
Show 1 more tools
  • codebase_symbols

Write 4 · Create, change, send or run things.

  • codebase_graph_build
  • codebase_index
  • codebase_stop
  • codebase_update

Delete 4 · Delete, drop, revoke or wipe things.

  • codebase_context_remove
  • codebase_graph_remove
  • codebase_prune
  • codebase_remove

Not yet classified 5 · We could not tell from the name and description.

  • codebase_about
  • codebase_context_index
  • codebase_flow
  • codebase_impact
  • codebase_watch

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • GOOGLE_API_KEY
  • LITELLM_API_KEY
  • LMSTUDIO_API_KEY
  • OLLAMA_API_KEY
  • OPENAI_API_KEY
  • QDRANT_API_KEY

Other settings (environment variables or headers).

  • EMBEDDING_DIMENSIONS
  • EMBEDDING_MODEL
  • EMBEDDING_PROVIDER
  • LITELLM_SEND_DIMENSIONS
  • LITELLM_URL
  • LMSTUDIO_ALLOW_MISSING_MODEL_LISTING
  • LMSTUDIO_URL
  • OLLAMA_MODE
  • OLLAMA_URL
  • QDRANT_MODE
  • QDRANT_URL

Files it touches

  • Any path the agent passes to its tools

Tools (26)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • codebase_about

    Display information about SocratiCode — what it is, its tools and how to use it. Use this to get a quick overview of the MCP tools and their purpose.

  • codebase_context

    List all context artifacts defined in .socraticodecontextartifacts.json — database schemas, API specs, infra configs, architecture docs, etc. Shows each artifact's name, description, path, and index status. Use this to discover what project knowledge is available beyond source code.

  • codebase_context_index

    Index or re-index all context artifacts defined in .socraticodecontextartifacts.json. Chunks and embeds artifact content into the vector database for semantic search. Usually not needed — codebase_context_search auto-indexes on first use.

  • codebase_context_remove

    Remove all indexed context artifacts for a project from the vector database. Blocked while indexing is in progress — use codebase_stop or wait for the operation to finish first.

  • codebase_context_search

    Semantic search across context artifacts (database schemas, API specs, infra configs, etc.) defined in .socraticodecontextartifacts.json. Auto-indexes on first use and auto-detects stale artifacts. Use this to find relevant infrastructure or domain knowledge.

  • codebase_flow

    Trace the EXECUTION FLOW forward from an entry point — what does this code call into? With NO args, returns a ranked list of auto-detected entry points (orphans with outgoing calls, conventional names like main(), framework routes, tests). With an entrypoint argument, returns the call tree.

  • codebase_graph_build

    Build a dependency graph of the codebase using static analysis (ast-grep). Maps import/require/export relationships between files. Runs in the background — call codebase_graph_status to poll progress until complete.

  • codebase_graph_circular

    Find circular dependencies in the codebase.

  • codebase_graph_query

    Query the code dependency graph for a specific file. Returns what the file imports and what files depend on it.

  • codebase_graph_remove

    Remove a project's persisted code graph. Waits for any in-flight graph build to finish first. The graph can be rebuilt with codebase_graph_build or will be rebuilt automatically on the next codebase_index.

  • codebase_graph_stats

    Get statistics about the code dependency graph: total files, edges, most connected files, orphan files, circular dependencies.

  • codebase_graph_status

    Check the status of the code dependency graph: build progress (if building), node/edge count, when it was last built, whether it's cached in memory. Use this to poll progress after calling codebase_graph_build.

  • codebase_graph_visualize

    Visualise the code dependency graph. Two modes: • mode="mermaid" (default) — returns a Mermaid diagram (text) colour-coded by language, circular deps highlighted. Best for inline rendering inside chat, GitHub, or editors that render Mermaid. • mode="interactive" — writes a self-contained HTML page (vendored Cytoscape.js + Dagre, works offline) and opens it in the user's default browser. Shows the file graph and, when a symbol graph is available and fits, a Symbols toggle with the symbol-level call graph. Interactions: click node for sidebar with imports/dependents/symbols list; right-click…

  • codebase_health

    Check the health of all infrastructure: Docker, Qdrant container, Ollama, and embedding model. Use this to diagnose setup issues.

  • codebase_impact

    Impact Analysis — return the BLAST RADIUS for a file or symbol. Lists every file (and, where helpful, function) that could break if you change the target. Polymorphic on target: a path-like string ('src/foo.ts') triggers file-mode; a name-like string ('validateUser') triggers symbol-mode. Use this BEFORE refactoring, renaming, or deleting code to know what depends on it.

Show 11 more tools
  • codebase_index

    Start indexing a codebase in the background. Returns immediately. Call codebase_status to poll progress until 100%. Do NOT search until indexing is complete. If already indexing, returns current progress.

  • codebase_list_projects

    List all projects that have been indexed (have collections in Qdrant).

  • codebase_prune

    Inventory stored project identities and their resources. Report-only by default. Applying requires an exact identity, the confirmation token from a fresh inventory, and an acknowledgement that no other host is writing to it; path absence on this host is advisory, not proof of abandonment.

  • codebase_remove

    Remove a project's codebase index entirely from the vector database. Safely stops the file watcher, cancels any in-progress indexing/update (with drain), and waits for any in-flight graph build before deleting.

  • codebase_search

    Semantic search across an indexed codebase. Only use after codebase_index is complete (check codebase_status first). Returns relevant code chunks matching a natural language query.

  • codebase_status

    Check index status: chunk count, indexing progress (%), last completed operation, file watcher state. Call after codebase_index to poll until 100% complete.

  • codebase_stop

    Gracefully stop an in-progress indexing operation. The current batch will finish and checkpoint, preserving all progress. Re-run codebase_index to resume from where it left off.

  • codebase_symbol

    360° view of a symbol: definition, kind, callers, callees, confidence levels. Use to understand a function or class before changing it.

  • codebase_symbols

    List symbols in a file, or search by name across the project. Use to discover what exists before drilling into a single symbol with codebase_symbol.

  • codebase_update

    Incrementally update an existing codebase index. Only re-indexes changed files. Runs synchronously. Use it to refresh a manual/off snapshot, working-tree edits before the next Git transition in git mode, or whenever an immediate catch-up is needed.

  • codebase_watch

    Start/stop watching a project directory for file changes and automatically update the index. When starting, first runs an incremental update to catch up, then watches for changes. SOCRATICODE_WATCHER=manual allows explicit starts only; off and git reject file-watcher starts. In git mode, status reports Git refresh state and stop does not disable Git checks.

Signals

Stars
3,354
Forks
431
Open issues
1
Contributors
29
Last commit
Oct 23, 2026 (5 days ago)
Last release
Oct 15, 2026 (13 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name
io.github.giancarloerra/socraticode
Version
1.16.1
Auth
API key
Packages
npm socraticode
License
AGPL-3.0
Repository
github.com/giancarloerra/socraticode
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql

More from giancarloerra

Cite this page

Socraticode MCP server. Agent Mart. https://agentmart.dev/connectors/giancarloerra-socraticode (last updated 2026-10-24)