← 返回目录

Codebase Memory

社区

面向 AI 编程代理的代码库知识图谱。

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

分类: 开发工具第 227 / 438
Stars: ★ 243 非常热门
传输方式: stdio（本地进程）
运行环境: 预编译二进制
凭据: 无需凭据
许可证: MIT
最近提交: 4 个月前
工具数: 15

52FMRS · D

这是一个由 win4r 维护的 MIT 社区分支，不是 DeusData 官方服务器。它适合本地代码库知识图谱和 AI 辅助代码探索；主要注意自行构建、配置文件写入，以及误运行 update 子命令会覆盖分支构建。

最强项 · 文档质量 13/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

12/20

维护活跃度

10/20

文档质量

13/20

安装易用性

9/20

查看各项评分依据

可靠性 8/20: 静态材料显示服务器采用stdio并列出npm/PyPI包，但仓库README明确说明该fork没有预构建二进制，且manifest仍指向上游仓库、上游版本和包信息，存在可复现性与发布身份不一致。README描述了大量工具和修复，但未提供本fork的CI、提交记录或关键路径测试证据，因此只能认为正常路径可能可用，扣除握手、错误处理和发布一致性的证据不足。
安全与权限 12/20: 材料表明主要处理在本地进行，不要求API密钥，并披露会读取代码库、写入代理配置、持久化缓存和提供删除项目功能；未见凭据窃取、隐蔽外传或默认远程执行证据，因此不触发红线。但自动配置、后台监视、更新下载、删除操作及curl管道安装的权限边界和确认机制不完整，也缺少可审计的数据流和本fork安全响应证据，故扣分。
维护活跃度 10/20: 仓库标注MIT、未归档，并声称集成多个上游修复；给出了上游安全渠道和更新方式，显示一定维护基础。但提供的材料没有本fork发布记录、提交频率、issue响应、依赖更新或明确维护者治理证据，且manifest仍描述上游项目，版本与归属不一致，因此不能按持续维护满分计。
文档质量 13/20: README覆盖安装、构建、平台、配置、工具类别、数据模型、限制、故障排查和安全声明，信息量较高。扣分原因是文档大量沿用上游内容，与fork无预构建发布的说明冲突；工具数量出现15、14等不一致，manifest包信息也与fork不匹配，且没有逐个完整参数、错误行为和可验证测试证据。
安装易用性 9/20: README提供源码构建、手动stdio配置和多个客户端示例，步骤总体可理解。可是fork要求本地编译158个语法库，首次构建耗时且需要编译器和依赖；manifest暗示npm/PyPI可直接运行，而README又称无预构建二进制，造成安装路径不确定。自动安装还涉及写入多个代理配置，故易用性和可预测性有限。

静态评测 · 未实际运行收录于 2026-08-14

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件连接数据库

适合谁

需要本地代码智能的 AI 编程代理。
需要跨文件调用解析、架构分析或增量索引的开发团队。
希望使用纯 C、stdio 和本地持久化存储的用户。

不适合谁

需要内置大语言模型或云端代码分析服务的用户。
不愿自行编译源代码或无法提供 C/C++ 编译环境的用户。
需要 SSE 或 streamable-http 传输的客户端。

所需权限

读取待索引的代码库和 Git 变更。
在本地缓存目录写入 SQLite 图数据库和相关配置。
安装或配置到支持的代码代理时，写入代理配置、指令文件、技能和钩子。
管理 ADR 时写入架构决策记录。

风险与副作用

工具会读取代码库，并可能写入代理配置文件。
该分支不提供预构建二进制，构建过程会编译大量 vendored 语法。
不要运行二进制的 update 子命令，因为它会拉取官方上游版本并覆盖此集成构建。
删除项目或本地缓存会移除相应图数据；代码本身不会因此被删除。

安装接入

准备工作

运行环境：预编译二进制

其他可选配置项（5 个）

CBM_CACHE_DIR 可选

CBM_DIAGNOSTICS 可选

CBM_DOWNLOAD_URL 可选

CBM_LOG_LEVEL 可选

CBM_WORKERS 可选

该分支不提供预构建二进制，需要从源代码构建。运行 git clone https://github.com/win4r/codebase-memory-mcp-pro.git，进入目录后执行 ./scripts/build.sh；将 build/c/codebase-memory-mcp 复制到 PATH，再使用 claude mcp add codebase-memory -s user -- ~/.local/bin/codebase-memory-mcp 配置 Claude Code。也可以使用 stdio MCP 配置，将 command 指向二进制的绝对路径。首次构建会编译 158 个 tree-sitter 语法，可能需要几分钟。

.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

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

生成并校验客户端配置

验证是否装好

在客户端运行 /mcp 应能看到 codebase-memory-mcp 及其 15 个工具；或对已索引项目执行 query_graph，确认返回非空结果。

常见排障

若 MCP 列表中没有服务器，检查配置文件中的 command 是否为二进制绝对路径，并重启客户端。
若 index_repository 失败，使用绝对 repo_path。
若 trace_path 没有结果，先用 search_graph 查找准确的限定名称。
若查询混入其他项目，使用 project 参数或先运行 list_projects。
若二进制找不到，将其所在目录加入 PATH。
若构建失败，检查 C/C++ 编译器、zlib、Git 和 macOS libgit2 环境。

试试这样问

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

帮我索引这个项目，然后列出所有已索引的项目
谁调用了 ProcessOrder 函数？给出完整调用链
查找所有没有任何调用者的死代码函数
查询 MATCH (f:Function)-[:CALLS]->(g) WHERE f.name = 'main' RETURN g.name

工具能力 15

index_repository 写入

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

list_projects 只读

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

delete_project 破坏性

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

index_status 只读

查询项目的索引状态。

search_graph 只读

按标签、名称模式、文件模式和度数过滤器搜索图节点。

trace_path 只读

使用 BFS 查询函数的调用者和被调用者，深度为 1 至 5。

detect_changes 只读

将 Git 变更映射到受影响符号，并提供风险分类和调用者影响范围。

query_graph 只读

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

展开其余 7 个工具

get_graph_schema 只读

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

get_code_snippet 只读

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

get_architecture 只读

返回语言、包、路由、热点、边界、层次、集群和 ADR 等架构信息。

search_code 只读

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

manage_adr 写入

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

ingest_traces 写入

导入运行时追踪信息以验证 HTTP_CALLS 边。

explore 只读

一次返回匹配符号的调用影响范围、附近邻居和按文件分组的行号源代码，并支持 query_graph/Cypher 逃生舱。

使用场景

建立代码库结构和调用关系的知识图谱。

追踪函数调用链、分析变更影响范围和发现潜在死代码。

通过 Cypher-like 查询、结构化搜索或代码搜索探索大型代码库。

获取架构概览、源代码片段和跨服务 HTTP 关系。

支持客户端

Claude Code

Codex

Gemini CLI

Zed

OpenCode

Antigravity

Aider部分支持

KiloCode

VS Code

OpenClaw

Kiro

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

详细介绍

Codebase Memory 是 DeusData/codebase-memory-mcp 的社区分支，由 win4r 维护。它使用纯 C 构建代码知识图谱，支持 158 种语言、结构化查询、调用链分析、影响范围检测、代码搜索和架构分析。该分支集成了增量重索引 CALLS 边修复、Cypher 查询修复、Swift 类型节点增强以及 explore 工具等改进。