Connection check
local install
socraticode
MCP server for local codebase indexing, semantic search, and code dependency graphs.
Tools
25
GitHub stars
—
Installs / wk
1.7k
Licence
—
Transport
stdio
Last checked
never
Tools & capabilities
25 toolsRead from the published package source — this server runs locally, so there is no endpoint to query. Names are taken from the code, not observed at runtime, and descriptions are often absent.
codebase_about
from source
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. 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
from source
List all context artifacts defined in .socraticodecontextartifacts.json — database schemas, API specs, infra configs, architecture docs, etc. Shows each artifact List all context artifacts defined in .socraticodecontextartifacts.json — database schemas, API specs, infra configs, architecture docs, etc. Shows each artifact
codebase_context_index
from source
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 n… 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
from source
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. 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
from source
Semantic search across context artifacts (database schemas, API specs, infra configs, etc.) defined in .socraticodecontextartifacts.json. Auto-indexes on first use and auto-detects… 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
from source
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… 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
from source
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_stat… 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
from source
Find circular dependencies in the codebase. Find circular dependencies in the codebase.
codebase_graph_query
from source
Query the code dependency graph for a specific file. Returns what the file imports and what files depend on it. Query the code dependency graph for a specific file. Returns what the file imports and what files depend on it.
codebase_graph_remove
from source
Remove a project Remove a project
codebase_graph_stats
from source
Get statistics about the code dependency graph: total files, edges, most connected files, orphan files, circular dependencies. Get statistics about the code dependency graph: total files, edges, most connected files, orphan files, circular dependencies.
codebase_graph_status
from source
Check the status of the code dependency graph: build progress (if building), node/edge count, when it was last built, whether it Check the status of the code dependency graph: build progress (if building), node/edge count, when it was last built, whether it
codebase_graph_visualize
from source
codebase_health
from source
Check the health of all infrastructure: Docker, Qdrant container, Ollama, and embedding model. Use this to diagnose setup issues. Check the health of all infrastructure: Docker, Qdrant container, Ollama, and embedding model. Use this to diagnose setup issues.
codebase_impact
from source
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… 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 (
codebase_index
from source
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, r… 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
from source
List all projects that have been indexed (have collections in Qdrant). List all projects that have been indexed (have collections in Qdrant).
codebase_remove
from source
Remove a project Remove a project
codebase_search
from source
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. 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
from source
Check index status: chunk count, indexing progress (%), last completed operation, file watcher state. Call after codebase_index to poll until 100% complete. Check index status: chunk count, indexing progress (%), last completed operation, file watcher state. Call after codebase_index to poll until 100% complete.
codebase_stop
from source
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. 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
from source
360° view of a symbol: definition, kind, callers, callees, confidence levels. Use to understand a function or class before changing it. 360° view of a symbol: definition, kind, callers, callees, confidence levels. Use to understand a function or class before changing it.
codebase_symbols
from source
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. 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
from source
Incrementally update an existing codebase index. Only re-indexes changed files. Runs synchronously. Usually not needed if file watcher is active. Incrementally update an existing codebase index. Only re-indexes changed files. Runs synchronously. Usually not needed if file watcher is active.
codebase_watch
from source