AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月17日
本地代码知识图谱 MCP 服务器,为 AI 代理提供代码结构上下文。
codebase-memory-mcp 是一个用 C 编写的 MCP 服务器,将代码、文档、配置和基础设施连接成持久化的本地知识图谱。它通过 17 个 MCP 工具向 AI 代理提供结构化上下文,并附带可选的 CBM Lens 可视化工具(开放测试版)。索引和查询无需托管服务或 API 密钥。
推荐指数
适合需要给 AI 代理提供代码结构上下文的开发者,本地运行、无需 API 密钥,但可视化组件尚在测试阶段。
近 7 天
+321
新增 Star
总 Star 排名
#116
雷达追踪的 3,971 个 AI 仓库中
创建于
2026
2026年2月25日
核心亮点
1本地知识图谱
代码、文档、配置和基础设施统一索引到本地持久化图谱,无需云端服务。
217 个 MCP 工具
通过 Model Context Protocol 向 AI 代理暴露符号搜索、调用关系、依赖查询等能力。
3多语言支持
内置语法解析支持 164 种语言和文件格式,并支持 Hybrid LSP 类型解析。
4变更感知测试
可评估代码变更影响范围,辅助选择需要运行的测试。
5CBM Lens 可视化
提供架构图、Galaxy 3D 图谱、源码阅读和本地代码问答,目前为开放测试版。
适用场景
AI 代理理解大型代码库
例如:让 Claude Code 通过 MCP 查询某个函数的调用者和依赖,而不是反复读取文件。
追踪跨服务调用
例如:沿着调用链从入口函数追踪到下游服务,定位功能实现位置。
评估变更影响
例如:修改一个模块前,查询哪些文件和测试可能受影响。
可视化代码结构
例如:用 CBM Lens 查看目录架构图和符号关系图,快速熟悉陌生项目。
它是怎么工作的
第 1 步
索引代码库
使用内置语法解析器分析源码、文档和配置文件,提取符号和关系。
第 2 步
构建知识图谱
将提取的实体和关系存入本地持久化图数据库(基于 SQLite)。
第 3 步
暴露 MCP 工具
通过 MCP 协议向 AI 代理提供 17 个查询工具,支持符号搜索、调用链、依赖分析等。
第 4 步
代理查询
AI 代理在编码过程中调用 MCP 工具获取结构化上下文,减少重复文件读取。
第 5 步
可视化与交互
可选启动 CBM Lens 查看架构图、3D 图谱,或进行本地代码问答。
快速上手
- 1
安装
从 GitHub Releases 下载对应平台(macOS/Linux/Windows)的二进制文件。
- 2
配置客户端
运行安装器,选择要集成的 AI 客户端(如 Claude Code、Cursor 等),自动写入配置。
- 3
索引仓库
通过 CLI 或 MCP 工具触发对目标代码库的索引。
- 4
开始查询
在 AI 代理中通过 MCP 工具查询代码结构,或启动 CBM Lens 可视化浏览。
适合谁
- 使用 AI 编码代理(如 Claude Code、Cursor)的开发者
- 需要理解大型或陌生代码库的研发团队
- 希望本地运行、避免代码外传的团队
- 需要评估代码变更影响范围的工程师
不太适合
- 不需要 AI 代理辅助编码的开发者
- 仅处理小型项目、无需结构化查询的场景
- 要求可视化工具完全稳定的生产环境
成熟度
- 活跃度最近推送在 2026 年 11 月,star 数超过 4.8 万,活跃度高。
- 文档README 详细,包含快速开始、功能说明和截图,但部分链接指向内部锚点。
- 社区有 Discord 社区和 4047 个 fork,开放 issue 570 个,社区规模较大。
- 上手难度提供安装器和 46 种客户端集成,但需要配置 MCP 客户端,对非 AI 代理用户门槛较高。
使用前注意
- · CBM Lens 可视化组件处于开放测试阶段(v0.0.1),功能可能不稳定。
- · 索引和查询在本地运行,大型代码库可能占用较多磁盘和内存资源。
- · 需要 AI 客户端支持 MCP 协议才能发挥核心功能。
- · MIT 许可证,可自由使用和修改。
