codebase-memory-mcp：本地代码图与 17 个 MCP 工具

codebase-memory-mcp 是 DeusData 开源的本地代码情报 MCP 服务：用原生 C 后端把源码、文档和基础设施配置打进持久知识图谱，给编程 Agent 提供 17 个 MCP 工具。索引与查询不依赖托管服务或 API key。最新正式版 v0.12.1。

它是什么

它把仓库解析成可查询的本地图：符号、调用、文件大纲、文档段落、Docker / K8s / Terraform / CI 等配置关系都能挂上。Agent 通过 Model Context Protocol 调工具做检索、溯源和变更影响分析；也可以用 CLI 直接查图。可选的 CBM Lens（open beta v0.0.1）提供架构地图、Galaxy 三维图和本地代码聊天，推理仍在本机。

解决什么问题

编程 Agent 默认靠反复读文件拼上下文：跨服务调用、部署链路、文档与实现的对应关系常被漏掉。codebase-memory-mcp 把「先建图、再按需查询」做成 MCP：用 search_graph / trace_path / detect_changes 等工具拿结构化结果，减少无效全文读取。索引会在会话间保留；活跃 MCP 会话还可按配置自动同步。

官方定位：给 Agent 结构上下文；大仓库同步索引可能超过客户端超时，README 要求改用 async: true 再轮询状态。

怎么用

# macOS / Linux：安装最新正式版
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash

# 可选：启动守护进程并打开 CBM Lens（默认端口 9749）
codebase-memory-mcp daemon start --open --port=9749

# 重启编程 Agent 后，对它说：Index this project
# 在支持 MCP 的客户端里用 /mcp 确认应看到 codebase-memory-mcp 与 17 个工具

安装脚本选项：--skip-config 只装二进制不改 Agent 配置；--dir=<path> 自定义目录。也可从 Releases 下载平台归档后本地执行 install.sh / install.ps1。README 另提供 Nix flake、AUR 与源码构建；Windows 需注意执行策略与 Mark-of-the-Web。

用法要点

MCP 工具分两类。索引侧：index_repository、list_projects、delete_project、index_status、check_index_coverage。查询侧：search_graph（结构 / BM25 / 语义）、trace_path（调用、数据流、跨服务、拓扑、部署、运行链路）、detect_changes、query_graph（只读类 Cypher）、get_graph_schema、compare_graphs、get_code_snippet、get_file_outline、get_architecture、search_code、manage_adr、ingest_traces。

大仓库注意：同步 index_repository 若被客户端取消，守护进程可能一并取消任务；应先 async: true 启动，再用同路径 status: true 轮询到 succeeded / failed。CLI 一次性 --async 在守护进程没有其它客户端时会被拒绝——需先 daemon start 或保持 MCP 会话。

安全与分发：分析与图存储默认在本机；CBM Lens 可选下载浏览器端模型，推理仍本地。README 提示 Microsoft Defender 可能对发行包误报，并给出校验与申诉说明；发布带校验和与 OpenSSF / SLSA 相关徽章。装前可读 SECURITY.md。

适合谁，不适合谁

适合：仓库大、跨服务多，希望 Claude Code / Cursor / Codex 等通过 MCP 做结构检索与变更影响分析的人；想把索引在团队间以图制品共享的人。

不适合：只想一次性导出静态图谱、不需要常驻 MCP 的轻量场景——graphify 更简单。CBM Lens 仍是 open beta，可以后装。若你更关心跨 Agent 会话记忆交接，本站另有 ai-memory。

最后：先跑官方 install 脚本，重启 Agent，让它执行一次「Index this project」，再用 /mcp 确认 17 个工具在线。