codebase-memory-mcp

技能简介

codebase-memory-mcp 是目前速度最快、效率最高的 AI 编程智能代码索引引擎。它可以在毫秒级内完成普通代码库的全量索引，Linux 内核（2800 万行代码、75000 个文件）也仅需 3 分钟即可完成。结构化查询响应时间低于 1 毫秒。以原生可执行文件形式分发，支持 macOS、Linux 和 Windows，下载后运行 install 即可完成安装和配置，完全无需 Docker、语言运行时或 API Key。

核心能力

1. 极速索引：Linux 内核（2800 万行代码、75000 个文件）仅需 3 分钟完成全量索引。RAM 优先管道：LZ4 压缩、内存 SQLite、Aho-Corasick 模式匹配，索引完成后内存释放回操作系统
2. 162 种编程语言：通过 tree-sitter AST 分析，覆盖 162 种语言的语法树分析，所有 tree-sitter 语法规则编译进二进制文件，无需额外安装任何语言运行时
3. 10 种语言的 Hybrid LSP 语义类型解析：支持 Python、TypeScript/JavaScript/JSX/TSX、PHP、C#、Go、C、C++、Java、Kotlin、Rust 和 Perl，实现参数绑定、返回值类型推断、泛型替换等高级语言特性解析
4. 120 倍 Token 节省：5 个结构化查询通过 codebase-memory-mcp 仅消耗约 3400 Token，而逐文件搜索方式需要约 412000 Token，节省 99.2%
5. 15 个 MCP 工具：内置搜索、追踪、架构分析、影响分析、索引覆盖率检查、Cypher 查询、死代码检测、跨服务 HTTP 链接、ADR 管理等 15 个工具
6. 45 个客户端自动配置：install 命令自动检测并配置已安装的编码 Agent（Claude Code、Codex、OpenCode 等），支持 45 种自动/条件客户端
7. 内置 3D 知识图谱可视化：在 localhost:9749 提供交互式 3D 可视化界面，浏览代码库的知识图谱
8. 基础设施即代码索引：Dockerfile、Kubernetes Manifest 和 Kustomize Overlay 作为图节点索引，支持 K8s 资源类型和 Kustomize 模块导入关系
9. 团队共享图谱构件：可将压缩后的知识图谱提交到代码仓库，队友克隆后直接导入，跳过重新索引
10. 本地运行、隐私安全：所有处理 100% 本地完成，代码从不离开用户机器；每次发布前经过 VirusTotal 三版本对比扫描

安装配置

macOS / Linux 一键安装：

curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash

Windows（PowerShell）：

# 1. 下载安装脚本
Invoke-WebRequest -Uri https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.ps1 -OutFile install.ps1
# 2. 解锁（移除浏览器的 Mark-of-the-Web 限制）
Unblock-File .install.ps1
# 3. 运行安装
.install.ps1

可选参数：--skip-config（仅安装二进制文件，不配置 Agent）、--dir=（自定义安装目录）。

npm / pip / Homebrew 等包管理器方式同样可用，通过相应包管理器安装后使用 npm install -g codebase-memory-mcp@latest 或 pip install -U codebase-memory-mcp 更新。

使用步骤

1. 安装并重启 Agent：安装脚本完成后，重启你的 AI 编码工具（Claude Code、Codex 等）
2. 告知 Agent 索引项目：在对话中输入"索引这个项目"或"Index this project"，MCP Server 自动检测项目类型并启动索引
3. 提出结构化查询：索引完成后，直接用自然语言提问，如"什么函数调用了 ProcessOrder？""这个模块的入口点是什么？""查找所有死代码"
4. 查看可视化图谱：在浏览器打开 http://localhost:9749 查看交互式 3D 知识图谱
5. 开启自动索引（可选）：运行 codebase-memory-mcp config set auto_index true，新项目在首次连接时自动索引，已有项目由后台 watcher 持续追踪 git 变更

适用场景

1. 大型代码库探索：快速理解陌生代码库的结构、入口点、依赖关系和模块边界
2. 代码重构影响分析：在重构前查询所有调用某函数的地方，评估改动影响范围
3. 死代码清理：快速发现未被调用的函数，减少代码维护负担
4. 架构可视化与文档：生成代码库架构图，辅助技术文档编写和团队知识传承
5. 跨服务依赖分析：通过 HTTP 路由与调用站点的匹配，发现前后端或微服务间的隐式依赖
6. 代码审查辅助：在 PR 中自动映射变更涉及的符号及其调用链，帮助审查者快速理解影响面

适用人群

软件工程师、架构师、技术负责人，以及任何需要频繁在大型代码库中导航、分析和重构的开发团队成员。

工作原理

codebase-memory-mcp 是一个结构化分析后端，通过 tree-sitter AST 解析构建代码库的知识图谱。它本身不包含 LLM，而是依赖你所使用的 MCP 客户端（如 Claude Code）作为智能层进行自然语言到图查询的转换。当你提问时，Agent 调用 MCP 工具执行图查询，结果以结构化数据返回，再由 Agent 呈现为人类可读的答案。

性能基准

官方链接

• GitHub：https://github.com/DeusData/codebase-memory-mcp
• 文档：https://deusdata.github.io/codebase-memory-mcp/
• arXiv 论文：https://arxiv.org/abs/2603.27277