Codebase-Memory-MCP

面向 AI 编码 Agent 的极速代码智能引擎——毫秒级索引、亚毫秒查询、120x token 节省

更新于 2026-08-10

一句话定位

一次图查询，替代几十次 grep/read 循环

用 tree-sitter 对 158 种语言建持久化知识图谱（函数/类/调用链/HTTP 路由/跨服务链接），纯 C 原生可执行文件 + MCP 协议接入。Linux 内核 28M LOC/75K 文件 3 分钟全量索引，结构查询 <1ms，无语言运行时、无托管服务、无 API key——下载即用。arXiv:2603.27277 论文背书。

核心数据

arXiv 论文（2603.27277）在 31 个真实仓库评估：83% 回答质量、10× 更少 token、2.1× 更少工具调用（对比逐文件探索）。43 个自动/条件客户端接入表面，macOS/Linux/Windows 原生二进制。

Agent 读代码的 token 危机

三层管道

• 158 个 vendored tree-sitter 语法编译进二进制，零安装零破坏
• Hybrid LSP 语义类型解析：纯 C 实现，兼容 tsserver/pyright/gopls/Roslyn/JDT/rust-analyzer 思路——参数绑定、返回类型推断、泛型替换、JSX 分发、PHP namespace + trait、C# LINQ、Java 类层级/重载、Kotlin 扩展函数、Rust trait/UFCS
• 融合 Aho-Corasick 模式匹配加速扫描；索引完释放内存
• 跨服务链接：Channel 检测（EMITS/LISTENS_ON，Socket.IO/EventEmitter/pub-sub，8 语言常量解析）+ SEMANTICALLY_RELATED 边（词汇不匹配同语言，score ≥ 0.80）

15 个 MCP 工具做什么

配套：图可视化 UI（localhost:9749）、自动索引（MCP 会话启动时）、CLI 模式（单命令，不启 daemon）、团队共享图 artifact。

下载即用

# 1. 下载原生可执行文件（macOS/Linux/Windows 预编译）
# 2. 运行安装
./codebase-memory-mcp install

# 3. 重启编码 Agent（Claude Code / Codex / Cursor / OpenCode…）
# 4. 说一句：
"Index this project"

原生安装无需 Docker、无需语言运行时、无需 API key。支持多 Agent：Claude Code、Codex、OpenCode、Cursor 等 43 个客户端表面，一个 daemon 协调共享索引与 watcher。AUR 也有包。

数字说话

一次图查询替代几十个 grep/read 周期；索引后内存释放；LZ4 压缩 + 内存 SQLite 保证毫秒级全量索引。

谁适合用

需要警惕

• 语义解析深度有限：Hybrid LSP 是轻量 C 实现，复杂泛型/宏/模板元编程场景不如完整语言服务器
• 论文预印本阶段：arXiv 背书是 preprint，评估规模（31 仓库）与权威性需独立验证
• 版本协调约束：所有活跃进程必须同版本同构建（ABI 一致性），升级要统一协调窗口
• 生态较新：43 客户端表面是宣称值，实际各客户端 MCP 支持成熟度不一
• 企业采用需评估：长期维护节奏、团队规模、C 代码库扩展性需持续观察

未来空间

代码智能是 Agent 编码体验的核心瓶颈，纯 C + 毫秒索引 + 亚毫秒查询的性能位一旦确立，token 成本结构就变了。若开源社区围绕 158 语言 + 15 工具构建技能生态，有成为 Agent 代码层默认索引引擎的潜力。