适合谁
- 需要本地代码结构分析的 AI 编程代理用户
- 希望减少文件级搜索和上下文 token 消耗的开发团队
- 需要跨文件、跨包或跨仓库关系查询的项目
C
63FMRS · C
依据提供的仓库说明、server.json 和 README：这是 MIT 许可、stdio 传输、本地运行的代码智能 MCP 服务器；官方维护者身份未获来源证明，因此 official 为 false。
Codebase Memory 是一个高性能代码智能 MCP 服务器，将代码库索引为持久化知识图谱，支持 158 种语言、亚毫秒级结构查询和 15 个 MCP 工具。它使用 tree-sitter AST，并对部分语言提供 Hybrid LSP 类型解析；所有处理均在本地完成，不包含内置 LLM。
工具能力
index_repository
将代码库索引到知识图谱，并支持后续自动同步。
list_projects
列出已索引项目及节点、边数量。
delete_project
删除项目及其全部图数据。
index_status
查看项目索引状态。
search_graph
按标签、名称模式、文件模式和度数条件进行结构化搜索。
trace_path
以 BFS 方式追踪函数的调用者和被调用者。
detect_changes
将 Git 变更映射到受影响符号，并评估影响范围和风险。
query_graph
执行只读的 Cypher-like 图查询。
get_graph_schema
返回节点、边、关系模式和属性定义。
get_code_snippet
按限定名称读取函数源代码片段。
get_architecture
返回代码库的语言、包、入口点、路由、热点和模块概览。
search_code
在已索引项目文件中执行类似 grep 的文本搜索。
manage_adr
创建、读取、更新和删除架构决策记录。
ingest_traces
导入运行时追踪数据，以验证 HTTP_CALLS 关系。
安装接入
可使用 macOS/Linux 安装脚本或 Windows PowerShell 安装脚本，也可从 GitHub Release 下载对应平台的二进制文件。安装后重启编程代理，并运行“Index this project”。也可以手动将提供的 stdio 配置加入 MCP 配置文件。
claude_desktop_config.json
{"mcpServers":{"codebase-memory-mcp":{"command":"/path/to/codebase-memory-mcp","args":[]}}}
选型与风险
不适合谁
- 需要内置 LLM 或自然语言到图查询翻译的用户
- 不希望服务器读取本地代码库的环境
- 只需要远程云端服务而不运行本地 stdio 进程的场景
所需权限
- 读取待索引的本地代码库和相关配置文件
- 向 ~/.cache/codebase-memory-mcp/ 写入持久化索引和日志
- 安装流程可能写入代理配置、指令、技能和生命周期钩子
- 可选 UI 使用 localhost:9749 提供本地图形界面
风险与副作用
- 索引和搜索会处理本地源代码，需审查其访问范围和缓存位置
- 安装器会修改代理配置文件、技能、指令或钩子
- 索引删除和卸载会删除相应数据或配置；图索引删除需确认
- 源码和二进制虽提供签名、校验和及扫描说明，仍应在运行前自行审计
常见排障
- 确认 MCP 配置中的 command 使用绝对路径
- 修改配置后重启编程代理，并用代理的 MCP 查看功能确认服务器已出现
- index_repository 使用绝对 repo_path，并在查询中指定正确的 project
- trace_path 无结果时先用 search_graph 查找准确的限定名称
- 若使用 UI，确认安装的是 UI 版本并访问 http://localhost:9749
使用场景
理解大型代码库的架构和模块边界
追踪函数调用链和变更影响范围
搜索代码、发现死代码并执行图查询
分析跨服务 HTTP、gRPC、GraphQL 和消息通道关系
在多个会话或团队之间复用代码知识图谱
支持客户端
Claude Code完整支持
Codex CLI完整支持
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部分支持