codebase-memory-mcp
活跃·★ 47.7k·MIT·更新于 2026-10-27
★ 最受欢迎
codebase-memory-mcp 是一个面向 AI 编程 Agent 的代码智能引擎。它用 tree-sitter 解析你的仓库，并对主流语言结合语言服务器做类型解析，再把结果保存为持久化的知识图谱。这样，Agent 回答“谁调用了这个函数”“改了这里会影响什么”“入口在哪里”这类结构性问题时，只需要一次图谱查询，而不必反复 grep 和读文件几十次。
它适合在中大型乃至超大型代码库中工作的开发者，这类场景下 Agent 的大部分 token 都花在了摸索代码上。项目方称，一个普通仓库的索引只需几毫秒，Linux 内核大约三分钟；在其自己的基准测试中，5 个结构性查询大约消耗 3,400 个 token，而逐个文件搜索约需 412,000 个。它提供 17 个 MCP 工具，能索引 Dockerfile 和 Kubernetes 清单等基础设施文件，还自带 3D 图谱查看器。其设计思路已发表为 arXiv 预印本。
上手方式：在 macOS 或 Linux 上运行一行安装命令，Windows 上运行 PowerShell 安装脚本。它会下载一个静态二进制文件（不需要 Docker、运行时或 API Key），并自动为检测到的编程 Agent 写好配置。重启 Agent 后，让它“索引这个项目”即可。
#知识图谱#代码库分析#AI助手工具#静态分析#Token效率#Tree-sitter#Go语言#开发者工具
01
功能特性
01基于 tree-sitter 把代码库索引成持久化知识图谱，并对多种主流语言做语义类型解析
02支持 150 多种语言，语法解析器都编译进单个静态二进制文件
03提供 17 个 MCP 工具：搜索、调用追踪、架构概览、影响分析、死代码检测、Cypher 查询等
04可以索引 Dockerfile、Kubernetes 清单等基础设施代码
05内置在本地运行的 3D 图谱可视化界面
02
为什么选择它
+代码探索时能大幅节省 token：一次图谱查询取代多次搜索和读取。
+索引速度很快，即使是超大仓库，查询也能在 1 毫秒内完成。
+单个静态二进制文件，无运行时依赖，也不需要 API Key；数据保存在本地。
+语言覆盖面广，支持众多编程 Agent，安装时会自动完成配置。
03
权衡点
!安装程序会修改 Agent 的配置文件，并加入说明和 hooks；请检查它改了什么，或使用 `--skip-config` 只安装二进制文件。
!部分杀毒软件曾把发布的二进制文件标记为可疑；项目方说明这是误报，并介绍了如何自行校验文件。
!基准数据来自项目方自测，建议在自己的仓库上实测节省效果。
!它会在多个客户端之间共用一个后台守护进程，出问题时排查环节会多一个。
05
维护状况检查
活跃检查日期: 2026-10-23
- 最近提交
- 2026-10-22
- 近 90 天提交数
- 100+
- 近 90 天发布数
- 13
- 最新发布
- v0.12.1 (2026-10-16)
- 未关闭 issue
- 640
- 近期 issue 至少有一条评论的比例
- 2/12
近 12 周每周提交数
最早的一周在左边，最近 4 周为橙色。数据来源：GitHub 提交统计。
状态规则：GitHub 上已归档 = 已归档；最近提交在 90 天内 = 活跃；91 到 365 天 = 放缓；更久 = 停滞。所有数字来自所示日期的 GitHub API。
讨论最多的未关闭 issue
- #1654 0.10.4 `index_repository` OOM-crashes on large repo — v0.9.0 indexed the same tree in ~13 min*24 条评论 · 2026-08-15
- #221 "install" command does not work for opencode in windows 1123 条评论 · 2026-04-07
- #1145 Windows-Indexing worker crashed on a file17 条评论 · 2026-07-17
- #45 Very high CPU usage16 条评论 · 2026-03-11
- #1582 Claude.ai Desktop App still cannot start mcp15 条评论 · 2026-08-13
issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。
04
适合谁
适合选它的情况
- 你的智能体在中大型代码库里搜索要消耗很多 token：按 README，一次图查询可以替代许多 grep 和读文件步骤。
- 想要全部在本地运行：单个静态二进制，没有运行时依赖，也不需要 API 密钥。
- 你使用多种语言和多个编码智能体，安装程序会自动配置。
建议换别的情况
- 你不希望安装程序修改智能体的配置文件并添加钩子：README 提供 --skip-config 只安装二进制。
- 你需要的是项目决策和约定，而不是代码结构：mex 之类的脚手架更接近。
- 你对未签名的二进制比较谨慎：个别杀毒引擎对该发布报过警，项目说明这是误报。
06
与同类的区别
07
兼容性
macOS
操作系统
已通过文档验证
Linux
操作系统
已通过文档验证
Windows
操作系统
已通过文档验证
Python
语言
已通过文档验证
Go
语言
已通过文档验证
JavaScript
语言
已通过文档验证
08
快速开始
1
$ curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash
09
使用场景
↳代码探索与理解：以低Token成本快速理解代码库架构、查找函数和追踪调用路径。
↳影响分析与重构：将Git差异映射到受影响的符号，检测死代码，并分析函数扇出，以辅助重构工作。
↳AI助手集成：通过精确的结构化查询增强Claude Code等AI助手，以更有效地回答代码相关问题。
↳架构决策记录管理：在代码库上下文中直接存储、更新和检索架构决策记录。
↳自动化脚本与CI/CD：在脚本或CI/CD流程中利用CLI模式进行单次图操作。
10
同类工具
收录于以下清单
评论
登录后发表评论
暂无评论，来发表第一条吧