你有没有遇到过这种情况：让 AI Agent 分析一个大型代码库，它要么逐个文件翻找，要么发出几十次 grep/read 调用，token 消耗巨大还经常漏掉关键信息？一个 5 次结构查询本该用 3,400 tokens 的任务，用传统方式要烧掉 412,000 tokens。

Codebase Memory MCP 就是来解决这个问题的。它是一个纯 C 实现的代码智能引擎，能在毫秒级时间内为整个代码库构建知识图谱，然后通过 MCP 协议让 AI Agent 直接查询函数调用链、跨服务依赖、死代码检测等结构信息——比逐文件搜索快 120 倍。

Codebase Memory MCP 是什么？ 由 DeusData 开发的开源代码智能引擎（MIT 许可证），通过 tree-sitter AST 分析和 Hybrid LSP 语义解析，为 158 种编程语言构建持久化知识图谱。以 MCP 协议暴露 14 个查询工具，兼容 Claude Code、Codex、Gemini CLI 等 11 个 AI 编码工具。纯 C 编写，单个静态二进制文件，零依赖。

关键数据：

• 🌟 GitHub Stars: 快速增长中（仓库链接）
• 📦 当前版本：v0.8.0
• ⚖️ 许可证：MIT License
• 🧠 核心特性：158 种语言支持，Hybrid LSP 覆盖 9 种主流语言的语义类型解析
• 📦 核心特性：Linux 内核（2800 万行代码）3 分钟完成全量索引，查询延迟 <1ms
• 🔒 安全认证：SLSA Level 3 + VirusTotal 70+ 引擎零检出 + CodeQL SAST
• 📄 学术论文：arXiv:2603.27277

前提条件

开始本 Codebase Memory MCP 安装教程前，你需要准备：

• 一个 AI 编码工具：Claude Code、Codex CLI、Gemini CLI、Zed、VS Code 等任意一个
• 操作系统：macOS（arm64/amd64）、Linux（arm64/amd64）或 Windows（amd64）
• 无需任何额外依赖：没有 Docker、没有 API Key、没有运行时依赖

概述

本教程是 Codebase Memory MCP 的完整使用指南，涵盖：

1. 一键安装到你的 AI 编码工具
2. 索引你的第一个代码库
3. 使用 14 个 MCP 工具进行代码查询
4. 在主流 AI 工具中配置和使用

详细步骤

第一步：一键安装

macOS / Linux：

1

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

需要图形化知识图谱可视化界面？加 --ui 参数：

1

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

Windows（PowerShell）：

1
2

Invoke-WebRequest -Uri https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.ps1 -OutFile install.ps1
.\install.ps1

安装脚本会自动完成以下工作：

1. 下载适合你平台的单个静态二进制文件
2. 检测你安装的所有 AI 编码工具
3. 自动配置每个工具的 MCP 服务器条目、指令文件和钩子

也可以通过包管理器安装：Homebrew、AUR（yay -S codebase-memory-mcp-bin）、npm、PyPI、Scoop、Winget、Chocolatey 都支持。

💡 提示：Windows 用户可能看到 SmartScreen 警告，点击”更多信息”→”仍要运行”即可。每个 release 都有 SHA-256 校验和可供验证。

第二步：在 AI 工具中安装

Codebase Memory MCP 的 install 命令会自动检测并配置以下 11 个 AI 编码工具：

通用方式：安装脚本会自动配置所有检测到的 Agent，重启 Agent 即可。

Claude Code 手动配置（如果自动配置未生效）：

在 ~/.claude/.mcp.json（全局）或项目 .mcp.json 中添加：

1
2
3
4
5
6
7
8

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

重启 Agent 后，用 /mcp 命令验证——应该能看到 codebase-memory-mcp 及其 14 个工具。

Codex CLI 手动配置：

在项目的 AGENTS.md 中添加 Codebase Memory MCP 的引用，或在 .codex/config.toml 中配置 MCP server。

第三步：索引你的第一个代码库

重启 Agent 后，直接说：

1

索引这个项目

或者通过命令行：

1

codebase-memory-mcp cli index_repository '{"repo_path": "/path/to/your/repo"}'

索引完成后，你就可以开始查询了。性能参考：

第四步：使用 14 个 MCP 工具

索引完成后，你可以通过 Agent 自然语言提问，也可以直接调用 MCP 工具：

结构查询：

• “谁调用了 ProcessOrder？” → trace_path
• “找出所有没有调用者的函数” → 死代码检测
• “这个项目的整体架构是什么？” → get_architecture

搜索：

• “搜索名为 Handler 的函数” → search_graph
• “用 Cypher 查询所有函数” → query_graph（支持 openCypher 子集）

变更分析：

• “这次 git diff 影响了哪些函数？” → detect_changes（带风险分类的爆炸半径分析）

跨服务链接：

• HTTP 路由 ↔ 调用点匹配（带置信度评分）
• gRPC、GraphQL、tRPC 服务检测
• Socket.IO、EventEmitter 等 Channel 检测

第五步：开启自动索引

启用后，新项目在首次连接时自动索引：

1

codebase-memory-mcp config set auto_index true

可配置文件上限：config set auto_index_limit 50000。

第六步：更新

1

codebase-memory-mcp update

MCP 服务器在启动时也会自动检查更新。

核心特性详解

Hybrid LSP：超越 tree-sitter 的语义解析

tree-sitter 只能做到语法级别的 AST 分析，无法追踪跨模块的类型解析。Codebase Memory MCP 内置了一层 Hybrid LSP——用纯 C 实现的语言类型解析算法，兼容 tsserver、pyright、gopls、Roslyn、rust-analyzer 等主流语言服务器的解析逻辑。

当前支持 Hybrid LSP 的 9 种语言：Python、TypeScript/JavaScript/JSX/TSX、PHP、C#、Go、C/C++、Java、Kotlin、Rust。

团队共享知识图谱

将 .codebase-memory/graph.db.zst 提交到仓库，队友克隆后跳过全量索引，只做增量更新。zstd 压缩比 8-13:1，支持两档导出（Best 和 Fast）。

内置 3D 图可视化

下载 UI 变体后，启动时加 --ui=true，在浏览器打开 http://localhost:9749 即可交互式浏览知识图谱。

常见问题（FAQ）

Q: Codebase Memory MCP 怎么安装？最简单的方法是什么？
A: macOS/Linux 一行命令：curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash。安装脚本自动下载二进制文件并配置所有检测到的 AI 编码工具。详见上方安装教程。

Q: 支持哪些 AI 编码工具？
A: 支持 11 个：Claude Code、Codex CLI、Gemini CLI、Zed、VS Code、OpenCode、Aider、KiloCode、Antigravity、OpenClaw、Kiro。安装脚本自动检测并配置。

Q: 和传统的逐文件搜索相比，token 消耗差距有多大？
A: 5 次结构查询消耗约 3,400 tokens，而逐文件 grep/read 方式需要约 412,000 tokens——减少 99.2%。arXiv 论文的评估显示，平均减少 10 倍 token 消耗和 2.1 倍工具调用次数。

Q: 需要 API Key 或 Docker 吗？
A: 完全不需要。单个静态二进制文件，零依赖，零 API Key。所有处理 100% 本地进行，代码不会离开你的机器。

Q: 支持哪些编程语言？
A: 158 种语言，全部通过内置的 tree-sitter 语法解析。其中 Python、TypeScript、JavaScript、PHP、C#、Go、C/C++、Java、Kotlin、Rust 还支持 Hybrid LSP 语义类型解析，准确率更高。

Q: 如何更新 Codebase Memory MCP？
A: 运行 codebase-memory-mcp update。MCP 服务器在启动时也会自动检查更新并通知你。

Q: 安全性如何保障？
A: 每个 release 二进制文件都经过 SLSA Level 3 构建认证、Sigstore 签名、VirusTotal 70+ 引擎扫描（零检出）、CodeQL 静态分析。纯 C 编写，零运行时依赖，无传递性供应链风险。

进阶技巧

• Cypher 图查询：支持 openCypher 读子集，可以写 MATCH (f:Function)-[:CALLS]->(g) WHERE f.name = 'main' RETURN g.name 这样的查询
• CLI 模式：所有 MCP 工具都可以通过命令行直接调用，适合脚本集成
• 自定义文件扩展名：通过 .codebase-memory.json 配置额外的文件扩展名映射（如 .blade.php → php）
• 架构决策记录：manage_adr 工具支持跨会话持久化架构决策

总结

以上就是 Codebase Memory MCP 的完整使用教程和安装指南。从一键安装到 11 个 AI 编码工具的自动配置，从毫秒级图查询到 158 种语言支持，这个工具让你的 AI Agent 真正”看懂”代码库的结构，而不是逐文件翻找。这套 Codebase Memory MCP 使用指南覆盖了从安装到进阶的全部流程，希望能帮你大幅提升 AI 编码的工作效率。

如何引用本文：本文基于 Codebase Memory MCP 官方 GitHub 仓库（2026-06-23 验证）编写。所有安装命令和功能信息均与 v0.8.0 版本对照验证。学术参考：arXiv:2603.27277。