### [codebase-memory-mcp：给 AI 编程助手装上「代码记忆」的知识图谱引擎（30.7K Star）](https://www.willai.cc/article/3760)

**Published:** 2026-07-13T05:59:35

**Author:** hiyoho

**Excerpt:** 项目简介 codebase-memory-mcp 是 DeusData 开源的高性能「代码智能」MCP 服务器。它把整个代码库预先解析成一张持久化的知识图谱，让 Claude Code、Cursor、Codex 等 AI 编程智能体通过结构

![codebase-memory-mcp 3D 知识图谱可视化](https://admin.hiyoho.com/wp-content/uploads/2026/07/shot-2.png)

## 项目简介

**codebase-memory-mcp** 是 DeusData 开源的高性能「代码智能」MCP 服务器。它把整个代码库预先解析成一张**持久化的知识图谱**，让 Claude Code、Cursor、Codex 等 AI 编程智能体通过结构化查询（而非逐文件读取）来理解代码——平均仓库**毫秒级建图**、查询**亚毫秒返回**，官方论文实测可节省约 **99% 的 token 消耗**。纯 C 实现、单静态二进制、零运行时依赖、100% 本地运行。

## 安装要求和过程

### 环境要求

-   **操作系统**：macOS（Apple Silicon / Intel）、Linux（x86\_64 / ARM64）、Windows（x86\_64）
-   **无需 Docker、无需运行时、无需 API Key**
-   **零依赖**：单静态二进制，运行时无任何外部依赖，下载即可运行
-   可选的 3D 可视化 UI 需浏览器访问 `localhost:9749`

### 快速安装

**macOS / Linux 一行安装（默认无 UI）：**

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

**带 3D 可视化界面：**

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

**Windows（PowerShell）：**下载 `install.ps1` 后执行 `Unblock-File .\install.ps1` 再运行 `.\install.ps1`。

也可通过 npm / PyPI / Homebrew / Scoop / Winget / Chocolatey / AUR 安装。安装脚本会**自动探测并写入 11 种 AI Agent 的 MCP 配置**（Claude Code、Codex、Gemini CLI、Zed、Cursor、VS Code、Aider、Kiro 等），重启 Agent 即生效。

## 核心功能

### 1\. 毫秒级代码建图

采用 RAM 优先管道（LZ4 压缩 + 内存 SQLite），平均仓库**毫秒级全量索引**，Linux 内核（2800 万行 / 7.5 万文件）仅需 3 分钟，索引完成后释放内存，不长期占用资源。

### 2\. 158 种语言 + Hybrid LSP 语义解析

内置 tree-sitter 语法覆盖 **158 种语言**，并对 Python / TypeScript / Go / Rust / C# / Java 等 11 种语言叠加 **Hybrid LSP 语义类型解析**，生成函数、类、调用链、HTTP 路由、跨服务链接等实体与关系组成的知识图谱。

### 3\. 14 个 MCP 工具

涵盖索引类（`index_repository` / `list_projects` / `delete_project` / `index_status`）与查询分析类（`search_graph` / `trace_path` / `query_graph` / `get_architecture` / `detect_changes` / `search_code` / `manage_adr` 等），覆盖搜索、调用链追踪、架构概览、改动影响面分析、死代码检测。

### 4\. 节省约 99% token

5 次结构化查询约 **3,400 token**，而逐文件搜索约 **412,000 token**，省下约 120 倍；一次图查询即可替代数十次 grep / read 循环，大幅缓解大仓库的上下文窗口焦虑。

### 5\. 11 种 Agent 一键接入 + 3D 图可视化

`install` 自动探测配置 Claude Code / Codex / Gemini CLI / Zed / Cursor / VS Code / Aider / Kiro 等 11 种 Agent；可选 UI 变体在 `localhost:9749` 提供交互式 3D 知识图谱浏览，直观查看调用关系与代码结构。

## 典型使用场景

### 1\. 大型代码库”秒懂”

在 5 万行以上的项目上，让 Claude Code 通过 `get_architecture` 一次拿到语言 / 包 / 路由 / 热点概览；问”谁调用了 ProcessOrder?”，由 `trace_path` 直接返回完整调用链，无需反复读取文件。

### 2\. 改动影响面分析

提交前运行 `detect_changes`，把 git diff 映射到具体符号并做风险分级，提前知道”改这个函数会波及哪些模块”，避免误删、误改导致线上故障。

### 3\. 团队共享代码记忆

将 `.codebase-memory/graph.db.zst` 压缩快照提交到 git，团队成员 clone 后免重复索引；新人也能立刻获得全局结构认知，降低上手成本。

## 推荐理由

作为重度使用 Claude Code 的开发者，这个项目最打动我的是**“把上下文探索从每次重新读文件，变成查询持久化图谱”**的思路。在 2800 万行的 Linux 内核上 3 分钟建完索引、查询亚毫秒返回，意味着 AI 助手不再因为上下文窗口焦虑而反复 grep、read，token 成本直接砍掉 99%。纯 C 单二进制、零依赖、100% 本地运行（代码不出机器）也是加分项，对个人隐私和多语言大型仓库非常友好。

一点小提醒：目前纯 C 实现对新语言的语义解析仍有分级（函数式语言如 OCaml / Haskell 解析度

## 下载地址

-   **GitHub**：[github.com/DeusData/codebase-memory-mcp](https://github.com/DeusData/codebase-memory-mcp)（⭐ 30.7K · MIT 许可）
-   **官方文档**：[deusdata.github.io/codebase-memory-mcp](https://deusdata.github.io/codebase-memory-mcp/)
-   **研究论文**：[arXiv:2603.27277](https://arxiv.org/abs/2603.27277)

**Tags:** AI, AI Agent, AI开源项目, codebase-memory-mcp, MCP, 代码智能, 开源, 知识图谱

**Categories:** 开源项目

---