What is this?
codebase-memory-mcp is a high-performance MCP server that indexes a codebase into a persistent knowledge graph so AI coding agents like Claude Code, Codex, Cursor, and Windsurf can query code structure instead of grepping files.
codebase-memory-mcp is a high-performance MCP server that indexes a codebase into a persistent knowledge graph so AI coding agents like Claude Code, Codex, Cursor, and Windsurf can query code structure instead of grepping files.Is this an MCP server I run locally, or a library I import?It is a standalone native executable (an MCP server) that your coding agent connects to — not a library you import into code.
It is a standalone native executable (an MCP server) that your coding agent connects to — not a library you import into code.How do I get it running?Run the official install script for your OS (a one-liner for macOS/Linux, a PowerShell script for Windows), restart your coding agent, and tell it to index the project.
Run the official install script for your OS (a one-liner for macOS/Linux, a PowerShell script for Windows), restart your coding agent, and tell it to index the project.Do I need Docker, a language runtime, or an API key to run it?No — the binary bundles 162 vendored tree-sitter grammars and an in-memory SQLite engine, so no Docker, language runtime, or API key is required.
No — the binary bundles 162 vendored tree-sitter grammars and an in-memory SQLite engine, so no Docker, language runtime, or API key is required.Any install pitfalls I should know about?Microsoft Defender sometimes flags the release binary as a trojan; the project documents this as a known false positive shared with tools like gh and llama.cpp, verified clean by roughly 61 of 62 VirusTotal engines.
Microsoft Defender sometimes flags the release binary as a trojan; the project documents this as a known false positive shared with tools like gh and llama.cpp, verified clean by roughly 61 of 62 VirusTotal engines.Does my code ever leave my machine?No — indexing and querying both run entirely on your local machine.
No — indexing and querying both run entirely on your local machine.What is the built-in graph visualization?CBM ships a 3D interactive graph UI served directly from the binary at localhost:9749, letting you explore functions, classes, call chains, and cross-service links visually.
CBM ships a 3D interactive graph UI served directly from the binary at localhost:9749, letting you explore functions, classes, call chains, and cross-service links visually.How many languages and MCP tools does it support?It parses 162 languages via vendored tree-sitter grammars and exposes 15 MCP tools for search, trace, architecture mapping, impact analysis, Cypher queries, and dead-code detection.
It parses 162 languages via vendored tree-sitter grammars and exposes 15 MCP tools for search, trace, architecture mapping, impact analysis, Cypher queries, and dead-code detection.Can it index infrastructure files like Dockerfiles or Kubernetes manifests?Yes — Dockerfiles, Kubernetes manifests, and Kustomize overlays are indexed as graph nodes, with resource nodes for K8s kinds and IMPORTS edges linking Kustomize overlays to their referenced resources.
Yes — Dockerfiles, Kubernetes manifests, and Kustomize overlays are indexed as graph nodes, with resource nodes for K8s kinds and IMPORTS edges linking Kustomize overlays to their referenced resources.Why is updating handled by a separate script instead of the running binary?On Windows a running executable can't overwrite its own image, and on macOS/Linux the authors chose not to bundle a downloader in the binary, so updates always go through the idempotent install script, which stops the daemon, swaps the binary, and restarts cleanly.
On Windows a running executable can't overwrite its own image, and on macOS/Linux the authors chose not to bundle a downloader in the binary, so updates always go through the idempotent install script, which stops the daemon, swaps the binary, and restarts cleanly.What are similar projects?graphicle, codegraph, graphify, axiomcodegraph, aoci-code, GitNexus, agent-skills, Benzi
graphicle, codegraph, graphify, axiomcodegraph, aoci-code, GitNexus, agent-skills, BenziWhich topics is it in?graph-visualization, code-intelligence, windsurf, ast, tree-sitter, code-analysis, infrastructure-as-code, gemini-cli, knowledge-graph, opencode, coding-agents, model-context-protocol
graph-visualization, code-intelligence, windsurf, ast, tree-sitter, code-analysis, infrastructure-as-code, gemini-cli, knowledge-graph, opencode, coding-agents, model-context-protocol