项目简介
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 -- --uiWindows（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（⭐ 30.7K · MIT 许可）
- 官方文档：deusdata.github.io/codebase-memory-mcp
- 研究论文：arXiv:2603.27277