Codebase Memory

项目简介

Codebase Memory（CBM）是开源 Model Context Protocol 服务器，为 AI 编程助手提供代码、文档和基础设施的持久本地知识图谱。它支持结构化、全文和本地语义搜索，关系追踪，源码证据检索，索引覆盖检查，并可通过可选的 CBM Lens 进行可视化探索。

核心功能

• 提供 17 个 MCP 工具，用于索引仓库、搜索符号和文本、查询图谱、追踪路径、获取代码片段、比较图谱和检查索引覆盖。
• 在代码、文档和基础设施之间构建连通图谱，涵盖调用关系、文档引用、架构决策、容器与部署配置以及受支持的 CI 步骤。
• 对受支持语言使用 tree-sitter 解析和 Hybrid LSP 类型解析，语言和框架覆盖范围依支持矩阵而异。
• 提供原生 CLI、持久索引，以及可选的 CBM Lens 开放测试版，用于源码导航、架构图和图谱探索。
• 实验性 Smart CI 测试选择利用变更影响、变更的测试和已接纳的覆盖率，解释变更可触达哪些测试。
• 源码分析和图存储在本机运行；原生版本无需 Docker 或语言运行时，索引和图谱查询无需 API 密钥。

适用场景

• 为 AI 编程助手提供持久仓库上下文，使其查找相关符号和源码片段，而不必反复读取整份文件。
• 跨文件、服务和已索引仓库追踪调用路径、依赖、路由、文档引用和部署路径。
• 通过将差异映射到受影响符号、比较图谱快照、检查相关测试并用实验性 Smart CI 聚焦受支持的 CI 运行来审查变更。
• 在 CBM Lens 中可视化探索架构和源码证据，同时检查索引覆盖和架构决策。

快速开始

• 在 macOS 或 Linux 上使用提供的安装脚本安装原生版本和智能体集成，重启编程助手后让它索引项目。
• 在 Windows 上使用 PowerShell 安装路径或文档中说明的其他安装方式。
• 可选运行 codebase-memory-mcp daemon start --open 启动 CBM Lens。

部署与要求

• 原生版本可在 macOS、Linux 和 Windows 上运行，原生运行时无需 Docker 或语言运行时。
• 索引和图谱查询无需 API 密钥。
• 提供原生包以及 npm、PyPI 和 Go 包装器；包装器使用各自运行时。
• 源码分析和图存储在本机运行，CBM Lens 通过回环地址提供服务。
• 启用后，Lens 的浏览器 AI 可下载可选模型。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。