codebase-memory-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CBM_WORKERS | No | Override the parallel-indexing worker count. Range 1-256. | |
| CBM_CACHE_DIR | No | Override the database storage directory. All project indexes and config are stored here. | ~/.cache/codebase-memory-mcp |
| CBM_LOG_LEVEL | No | Set the minimum log level. Accepted values: debug, info, warn, error, none or 0-4. | info |
| CBM_DIAGNOSTICS | No | Set to '1' or 'true' to enable periodic diagnostics output to /tmp/cbm-diagnostics-<pid>.json. | false |
| CBM_DOWNLOAD_URL | No | Override the download URL for updates. Used for testing or self-hosted deployments. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| index_repositoryA | Index a repository into the knowledge graph. Special mode 'cross-repo-intelligence': skip extraction, only match Routes/Channels across projects to create CROSS_HTTP_CALLS/CROSS_ASYNC_CALLS/CROSS_CHANNEL edges. Requires target_projects param. Ensure target projects have fresh indexes first. |
| search_graphA | Search the code knowledge graph for functions, classes, routes, and variables. Use INSTEAD OF grep/glob when finding code definitions, implementations, or relationships. Three search modes: (1) query='update settings' for BM25 ranked full-text search with camelCase splitting and structural label boosting — recommended for natural-language discovery; (2) name_pattern='.regex.' for exact pattern matching; (3) semantic_query=[...] for vector cosine search that bridges vocabulary (finds 'publish' when you search 'send'). The three modes are independent and can be combined in a single call. PAGINATION: results are capped at limit (default 200) — broader queries are silently truncated. The response always includes 'total' (full match count before limit) and 'has_more' (true when total > offset+returned). Detect truncation with has_more, then page by re-calling with offset=offset+limit until has_more is false. Narrow first via label/file_pattern/min_degree before paginating large result sets. |
| query_graphA | Execute a Cypher query against the knowledge graph for complex multi-hop patterns, aggregations, and cross-service analysis. The response includes 'total' (returned row count). There is a hard 100k row ceiling — for broad queries add LIMIT in the Cypher itself or use search_graph + offset/limit pagination instead. |
| trace_pathA | Trace paths through the code graph. Modes: calls (callers/callees), data_flow (value propagation with args at each hop), cross_service (through HTTP/async Route nodes). Use INSTEAD OF grep for callers, dependencies, impact analysis, or data flow tracing. |
| get_code_snippetA | Read source code for a function/class/symbol. IMPORTANT: First call search_graph to find the exact qualified_name, then pass it here. This is a read tool, not a search tool. Accepts full qualified_name (exact match) or short function name (returns suggestions if ambiguous). |
| get_graph_schemaC | Get the schema of the knowledge graph (node labels, edge types) |
| get_architectureB | Get high-level architecture overview — packages, services, dependencies, and project structure at a glance. |
| search_codeA | Graph-augmented code search. Finds text patterns via grep, then enriches results with the knowledge graph: deduplicates matches into containing functions, ranks by structural importance (definitions first, popular functions next, tests last). Modes: compact (default, signatures only — token efficient), full (with source), files (just file paths). Use path_filter regex to scope results. TRUNCATION: enriched results are capped at limit (default 10). Response carries 'total_grep_matches' (raw grep hit count) and 'total_results' (deduplicated function count) — compare to limit to detect truncation. There is no offset parameter; to see more, raise limit or narrow the query with file_pattern / path_filter. |
| list_projectsB | List all indexed projects |
| delete_projectC | Delete a project from the index |
| index_statusC | Get the indexing status of a project |
| detect_changesD | Detect code changes and their impact |
| manage_adrC | Create or update Architecture Decision Records |
| ingest_tracesC | Ingest runtime traces to enhance the knowledge graph |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/DeusData/codebase-memory-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server