codegraph-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CODEGRAPH_ROOT | No | The directory to index. The server indexes the directory it is started in, or the path given via --root / CODEGRAPH_ROOT. | |
| CODEGRAPH_NO_PROXY | No | Set to 1 to disable the proxy supervisor. | |
| CODEGRAPH_MIN_LINES | No | Changes the line threshold for the PreToolUse hook (default 300). | |
| CODEGRAPH_PROXY_PORT | No | The port for the proxy (default 3210). |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| repo_mapA | Project map: languages, symbol counts, key files ranked by import centrality. Call FIRST to orient. html=true also writes an interactive architecture map. |
| find_symbolB | Find a definition by name, repo-wide. Returns file:line, signature and container. |
| read_symbolA | Full source of ONE symbol (function/class/method) without reading the whole file. |
| file_skeletonA | File outline: imports + every signature with line ranges, no bodies. Use before reading a file in full. |
| semantic_searchA | Find code/notes BY MEANING ("where is auth token validated") when the exact name is unknown. Local embeddings; keyword fallback offline. |
| usage_statsB | Usage counters and estimated tokens saved. dashboard=true also writes an HTML report and returns its path. |
| find_referencesA | Every mention of an identifier repo-wide (calls marked [call], plus types, variables, imports), with the enclosing symbol. Word-boundary, case-sensitive. |
| who_importsB | Files that import a given module — its direct dependents. |
| analyze_impactA | Transitive callers of a symbol — the blast radius. Run BEFORE changing a signature or behavior. |
| reindexB | Force a re-scan of the repository. Use full=true to rebuild the index from scratch. |
| save_noteA | Save a short project note (decision, gotcha, convention) that survives across sessions. |
| recall_notesB | Saved project notes: most relevant first with a query, newest first without. Safe to call argless at task start. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 12 tools
Most tools target clearly different operations: find_symbol (definitions), find_references (all usages), semantic_search (by meaning), who_imports (module dependents), and analyze_impact (transitive callers) are well-differentiated by their descriptions. Minor overlap exists between find_references and who_imports (both touch imports) and between read_symbol and file_skeleton (both read code), but the granularity distinctions keep them separable.
All names use consistent snake_case, and most follow a verb_noun or action-oriented pattern (save_note, find_symbol, read_symbol, find_references, analyze_impact, recall_notes). A few deviate into noun phrases (repo_map, file_skeleton, usage_stats, semantic_search) and one is a bare verb (reindex), but the pattern remains readable and predictable.
12 tools is well-scoped for a code-navigation/graph server, with each tool covering a distinct facet (index, map, locate, read, outline, search, references, impact, stats, notes). No redundancy and no tool feels extraneous.
Coverage spans indexing (reindex), orientation (repo_map, file_skeleton), discovery (find_symbol, semantic_search, find_references, who_imports), impact analysis, and notes persistence (save_note/recall_notes). The main gap is a plain literal/regex text search tool, though the semantic_search keyword fallback partly compensates.