SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI编程工具codebase-memory-mcp

codebase-memory-mcp

codebase-memory-mcp 是一个本地运行的代码智能 MCP（Model Context Protocol）服务器，由 DeusData 开发。它将代码仓库索引成持久化的本地知识图谱，记录函数、类、导入、HTTP 路由及其相互关系，支持 162 种语言。该项目基于 tree-sitter 语法解析，并叠加混合 LSP 做语义类型解析（覆盖 Python、TypeScript、JavaScript、JSX/TSX、PHP、C#、Go、C、C++、Java、Kotlin、Rust、Perl）。它以单个静态二进制分发，零依赖，索引与图查询不需要调用托管服务或 API 密钥。官方称平均仓库可在毫秒级完成索引，发布的后端基准显示约 2800 万行的 Linux 内核约 3 分钟完成索引，Cypher 关系查询在 Apple M3 Pro 上低于 1 毫秒。在项目报告的五个查询对比中，相比逐文件探索约减少 120 倍 token 用量（约 3,400 vs 约 412,000）。原生 C 后端提供 17 个 MCP 工具，支持 45 种自动或条件式客户端集成。项目还包含 CBM Lens Beta 浏览器界面，提供 IDE 风格源代码阅读、本地代码聊天、3D 架构图和 Galaxy 图，用于理解陌生代码与跟踪依赖和调用路径。

访问官网

工具介绍

用途

codebase-memory-mcp 是一个本地 Model Context Protocol（MCP）服务器，为 Claude Code、Codex 等编码智能体提供持久化的代码知识图谱。它把代码库索引为函数、类、导入、HTTP 路由及其之间的跨服务关系，用于代码搜索、调用图跟踪和软件架构探索。

主要能力

  • 持久知识图谱：将仓库索引为本地知识图谱，记录函数、类、导入、HTTP 路由及关系。
  • 多语言支持：索引支持 162 种语言，tree-sitter 语法已内置编译进二进制，无需单独安装解析器。混合 LSP 为 Python、TypeScript、JavaScript、JSX/TSX、PHP、C#、Go、C、C++、Java、Kotlin、Rust、Perl 增加语义类型解析。
  • 性能：官方称平均仓库毫秒级索引；发布的后端基准报告 Linux 内核（2800 万行、75K 文件）约 3 分钟完成索引，Cypher 关系查询在 Apple M3 Pro 上低于 1 毫秒。项目报告的五个查询对比中约减少 120 倍 token（约 3,400 vs 约 412,000）。
  • 17 个 MCP 工具：搜索、跟踪、架构、影响分析、定向索引覆盖检查、Cypher 查询、死代码检测、跨服务 HTTP 链接、ADR 管理等。
  • 基础设施即代码索引：Dockerfile、容器镜像、docker compose、Kubernetes manifest、Kustomize overlay 作为图谱节点并建立交叉引用。
  • CBM Lens Beta：浏览器界面，提供 IDE 风格源代码阅读器、本地代码聊天、3D 架构图、Galaxy 图、覆盖率检查和架构决策记录编辑。
  • 多客户端集成：支持 45 种自动或条件式客户端表面；安装时会配置检测到的客户端，并在符合文档所述平台、标记或已有配置路径时安全激活条件式客户端。

使用方式

通过安装脚本安装最新发布版（macOS / Linux）：使用 tar 解压后运行 ./install.sh；Windows 使用 PowerShell 的 Expand-Archive 与 ./install.ps1。安装选项包括 --skip-config（只装二进制、不配置智能体）和 --dir=<path>（自定义位置）。安装命令会自动去掉 macOS quarantine 属性并对二进制做 ad-hoc 签名。安装完成后重启编码智能体，说 “Index this project” 即可开始。也可以从最新 release 下载对应平台压缩包（macOS/Linux 为 .tar.gz，Windows 为 .zip）手动安装。安装命令会自动检测已安装的编码智能体，配置其文档所述的 MCP 条目，并在支持时写入持久指令、技能和生命周期钩子。

CBM Lens Beta 可通过启动本地服务器使用，浏览器打开 http://127.0.0.1:9749；永久守护进程让 UI 在命令退出后仍可用，使用 daemon status 检查、daemon stop 停止；MCP 会话中使用 --ui=true --port=9749 启用同一共享 UI。打开项目菜单选择 Add project index（或 Alt+P），选择本地仓库文件夹并为索引命名，文件保持原位，开始索引后可关闭对话框并在项目菜单中重新打开活动。

架构视图包含 Overview（3D 地图浏览源码文件夹与文件）、Entry points、Routes（服务图与端点连接）、Hotspots（基于 fan-in 和复杂度等实测信号，非代码质量评分）、System structure（组件依赖、分组、循环隔离）、Behavior（静态调用路径及源码语句，非实际执行顺序；运行时观察需要另行导入 trace）。视图可用 ?project=<name>&workspace=architecture 书签化，其他 workspace 值有 explore、galaxy、adr、coverage、system。

适用场景

  • 快速熟悉不熟悉的代码库。
  • 对继承来的项目进行“救援工程”。
  • 理解短时间内 AI 生成的大量代码（如一天生成 5 万行）。
  • 审查变更、调查脆弱区域并保持代码质量。
  • 在浏览器中阅读源码、跟踪依赖与调用路径，并围绕选中代码与本地模型对话。

限制与说明

  • 索引与图查询不需要托管服务或 API 密钥；源码分析与图存储在本机进行。CBM Lens 可选择下载浏览器 AI 模型，启用后推理仍在设备上。
  • CBM Lens Beta 随 PR #2068 进入 main，不属于当前 v0.11.0 发布版；该发布版的安装器仍提供旧的图 UI。要立即使用所示界面需从源码构建。
  • 所有活动中的 CBM 进程必须使用完全相同的版本、可执行构建、协调 ABI 和规范缓存根目录；真正不同的缓存根目录在任何 CBM 进程活动时会被拒绝。
  • 微软 Defender 可能将发布二进制标记为 Trojan:Script/Wacatac.B!ml，官方说明这是已知误报（通常 62 个引擎中约 61 个返回干净），并提供了自行验证与报告方式。
  • 安装时如遇脚本执行策略错误，可先运行 Set-ExecutionPolicy -Scope Process Bypass，或用 PowerShell -ExecutionPolicy Bypass -File .\install.ps1 调用。
  • 关于收费、价格等具体信息，资料中暂未提供。

同类工具

查看分类