← 返回目录

Codebase Memory

社区

为 AI 编程代理构建持久化代码知识图谱。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 74 / 438
Stars: ★ 46.9k 非常热门
传输方式: stdio（本地进程）
运行环境: 预编译二进制 · Node.js · Python
凭据: 无需凭据
许可证: MIT
最近提交: 8 天前
工具数: 14

63FMRS · C

依据提供的仓库说明、server.json 和 README：这是 MIT 许可、stdio 传输、本地运行的代码智能 MCP 服务器；官方维护者身份未获来源证明，因此 official 为 false。

最强项 · 文档质量 15/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

11/20

维护活跃度

14/20

文档质量

15/20

安装易用性

13/20

查看各项评分依据

可靠性 10/20: 清单声明为 stdio 传输，README 描述了 MCP 工具、CLI、持久化和错误诊断路径，且声称存在 CI 与大量测试。但本次仅提供清单和 README，未提供实际源码、工作流或测试文件，无法验证初始化握手、工具列表、参数校验和异常路径；文档还称有 15 个工具，而列出的表格可数为 14 个。依据静态规则，可靠性不超过 12，扣分来自未验证的关键执行证据和声明不一致。
安全与权限 11/20: README 明确说明本地处理、无遥测、无需 API 密钥，并提供 CBM_ALLOWED_ROOT、缓存目录隔离、校验和、签名、SLSA 和安全报告渠道，这些证据支持基本的数据边界与供应链控制。扣分原因是安装器会写入多个代理配置、指令、技能和生命周期钩子，默认更新检查会访问网络，默认允许索引任意路径（CBM_ALLOWED_ROOT 未设置），并可删除项目图数据；尽管部分操作有说明或确认，最小权限、安装器完整行为和删除确认机制无法由提供材料独立验证。未发现提示中的红线风险。
维护活跃度 14/20: 项目未归档，提供 MIT 许可证、版本号 0.8.1、GitHub 发布路径、更新命令、安全报告入口，并声明 CI、CodeQL 和持续发布流程；这些信息表明有明确维护者和更新机制。扣分原因是没有提供提交历史、发布频率、问题响应时间、依赖更新记录或安全公告历史，因此无法证明持续维护质量达到满分。
文档质量 15/20: README 覆盖安装、手动配置、平台、工具分类、数据模型、环境变量、忽略规则、持久化、故障排查、性能和安全声明，并给出 Claude 配置示例，文档完整度较高。扣分原因包括 158 与 159 种语言的表述不一致、15 个工具与表格数量不一致、性能和测试数字缺少可复核的源码或基准证据，以及对权限写入、自动更新和后台守护进程的实际行为仍主要依赖项目自述。
安装易用性 13/20: 提供 macOS、Linux、Windows 的安装路径、预编译二进制、npm/PyPI 等渠道、UI 可选项、手动 MCP 配置和多客户端自动配置，主流客户端的连接步骤清楚。扣分原因是安装脚本会修改代理配置和钩子，curl/PowerShell 远程脚本路径增加供应链与审查成本；manifest 的 npx/uvx 包路径与 README 重点介绍的原生二进制安装路径也未在材料中得到可执行验证。静态规则下未有源码级执行证据，因此不接近满分。

静态评测 · 未实际运行收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件

适合谁

需要本地代码结构分析的 AI 编程代理用户
希望减少文件级搜索和上下文 token 消耗的开发团队
需要跨文件、跨包或跨仓库关系查询的项目

不适合谁

需要内置 LLM 或自然语言到图查询翻译的用户
不希望服务器读取本地代码库的环境
只需要远程云端服务而不运行本地 stdio 进程的场景

所需权限

读取待索引的本地代码库和相关配置文件
向 ~/.cache/codebase-memory-mcp/ 写入持久化索引和日志
安装流程可能写入代理配置、指令、技能和生命周期钩子
可选 UI 使用 localhost:9749 提供本地图形界面

风险与副作用

索引和搜索会处理本地源代码，需审查其访问范围和缓存位置
安装器会修改代理配置文件、技能、指令或钩子
索引删除和卸载会删除相应数据或配置；图索引删除需确认
源码和二进制虽提供签名、校验和及扫描说明，仍应在运行前自行审计

安装接入

准备工作

运行环境：预编译二进制 · Node.js · Python

其他可选配置项（8 个）

CBM_ALLOWED_ROOT 可选可选，将 index_repository 限制在指定目录内，适用于不可信调用方场景。

CBM_CACHE_DIR 可选可选，覆盖索引数据库存储目录，默认 ~/.cache/codebase-memory-mcp。

CBM_DIAGNOSTICS 可选可选，设为 1/true 启用守护进程的资源快照与 trajectory.nd 诊断日志。

CBM_DOWNLOAD_URL 可选可选，覆盖更新下载地址，用于测试或自托管部署。

CBM_LOG_LEVEL 可选可选，设置最低日志级别（debug/info/warn/error/none），默认 info。

CBM_WORKERS 可选可选，覆盖并行索引 worker 数量（1–256），适合容器环境。

CBM_MEM_BUDGET_MB 可选可选，以 MiB 显式指定内存图预算上限，优先于自动检测。

CBM_DUMP_VERIFY_MIN_RATIO 可选可选，持久化节点数与内存节点数的最小比例校验阈值，默认 0.5。

可使用 macOS/Linux 安装脚本或 Windows PowerShell 安装脚本，也可从 GitHub Release 下载对应平台的二进制文件。安装后重启编程代理，并运行“Index this project”。也可以手动将提供的 stdio 配置加入 MCP 配置文件。

.mcp.json

{"mcpServers":{"codebase-memory-mcp":{"command":"/path/to/codebase-memory-mcp","args":[]}}}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "codebase-memory-mcp": {
      "command": "/path/to/codebase-memory-mcp",
      "args": []
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add codebase-memory-mcp -- /path/to/codebase-memory-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

重启 agent 后运行 /mcp，应能看到 codebase-memory-mcp 及其 15 个工具；或者说“索引这个项目”，成功后用 list_projects 能看到该项目及节点/边数量。

常见排障

确认 MCP 配置中的 command 使用绝对路径
修改配置后重启编程代理，并用代理的 MCP 查看功能确认服务器已出现
index_repository 使用绝对 repo_path，并在查询中指定正确的 project
trace_path 无结果时先用 search_graph 查找准确的限定名称
若使用 UI，确认安装的是 UI 版本并访问 http://localhost:9749

试试这样问

连接成功后，可以直接对 AI 助手这样说：

索引这个项目
trace_path 查一下谁调用了 ProcessOrder
用 query_graph 查出没有任何调用者的死代码函数
给我这个代码库的整体架构概览

工具能力 14

index_repository 写入

将代码库索引到知识图谱，并支持后续自动同步。

list_projects 只读

列出已索引项目及节点、边数量。

delete_project 破坏性

删除项目及其全部图数据。

index_status 只读

查看项目索引状态。

search_graph 只读

按标签、名称模式、文件模式和度数条件进行结构化搜索。

trace_path 只读

以 BFS 方式追踪函数的调用者和被调用者。

detect_changes 只读

将 Git 变更映射到受影响符号，并评估影响范围和风险。

query_graph 只读

执行只读的 Cypher-like 图查询。

展开其余 6 个工具

get_graph_schema 只读

返回节点、边、关系模式和属性定义。

get_code_snippet 只读

按限定名称读取函数源代码片段。

get_architecture 只读

返回代码库的语言、包、入口点、路由、热点和模块概览。

search_code 只读

在已索引项目文件中执行类似 grep 的文本搜索。

manage_adr 写入

创建、读取、更新和删除架构决策记录。

ingest_traces 写入

导入运行时追踪数据，以验证 HTTP_CALLS 关系。

使用场景

理解大型代码库的架构和模块边界

追踪函数调用链和变更影响范围

搜索代码、发现死代码并执行图查询

分析跨服务 HTTP、gRPC、GraphQL 和消息通道关系

在多个会话或团队之间复用代码知识图谱

支持客户端

Claude Code

Codex

Gemini CLI

Zed部分支持

OpenCode

Cursor部分支持

Windsurf部分支持

Aider部分支持

KiloCode

VS Code

GitHub Copilot CLI

OpenHands部分支持

Cline部分支持

Qwen Code

Factory Droid

Goose部分支持

Mistral Vibe

Qoder CLI

Kimi Code CLI

Rovo Dev CLI部分支持

依据项目文档列出，未经本站实测。

详细介绍

Codebase Memory 是一个高性能代码智能 MCP 服务器，将代码库索引为持久化知识图谱，支持 158 种语言、亚毫秒级结构查询和 15 个 MCP 工具。它使用 tree-sitter AST，并对部分语言提供 Hybrid LSP 类型解析；所有处理均在本地完成，不包含内置 LLM。