技术深度分析报告

Codebase-Memory-MCP

面向 AI 编码 Agent 的极速代码知识图谱——
纯 C 单文件,毫秒级全仓索引。

github.com/DeusData/codebase-memory-mcp MIT Pure C 158 语言 arXiv 论文

Linux Kernel 28M LOC · 3 分钟索引 · <1ms 查询 · SLSA 3 安全等级

← 返回汇总
项目速览

一句话定义

给代码仓库建一张可查询的地图。

3min
Linux Kernel 索引
<1ms
结构查询
120x
token 节省
158
支持语言

5604 测试通过 · 11 Agent 集成 · 14 MCP 工具 · arXiv:2603.27277

为什么存在

Agent 读不懂大仓库

上下文塞不下

大仓库代码量远超 LLM 窗口,Agent 只能看局部,丢失全局。

grep + read 太慢

逐文件搜索读代码,token 消耗巨大,且找不到逻辑关联。

语义关系丢失

纯文本检索找不到调用链、跨服务 HTTP 链接等结构关系。

核心理念

代码即图,查询即遍历

不是搜文本,是查图谱。

把整个代码仓库解析成持久化知识图谱——函数、类、调用链、HTTP 路由、跨服务链接都是节点。Agent 用图查询代替 grep/read 循环。

极致性能

为什么这么快

指标数据
Linux Kernel 索引28M LOC / 75K 文件 / 3 分钟
结构查询延迟< 1ms
token 节省120x(5 查询 ~3.4K vs ~412K tok)
工具调用减少2.1x
答案质量83%(31 真实仓库评估)

RAM-first 流水线:LZ4 压缩、内存 SQLite、fused Aho-Corasick 模式匹配。索引后释放内存。

图谱建模

图谱里有什么

代码节点

函数、类、方法、变量,含类型与签名。

调用关系

函数调用链、类继承、模块导入边。

HTTP 路由

API 端点、跨服务链接,微服务拓扑。

基础设施

Dockerfile、K8s manifest、Kustomize 作为图节点。

能力矩阵

14 个 MCP 工具

search

语义代码搜索

trace

调用链追踪

architecture

架构概览

impact analysis

影响范围分析

Cypher queries

图数据库查询

dead code

死代码检测

cross-service

跨服务 HTTP 链接

ADR management

架构决策记录

...更多

共 14 个工具

生态覆盖

11 个 Agent,一条命令

install 自动检测并配置所有支持的 Agent。

Claude Code Codex CLI Gemini CLI Zed OpenCode Antigravity Aider KiloCode VS Code OpenClaw Kiro
快速上手

一行装好

# macOS / Linux 一键装
curl -fsSL https://raw.githubusercontent.com/DeusData/\
codebase-memory-mcp/main/install.sh | bash

# 带 3D 图谱可视化 UI
curl -fsSL .../install.sh | bash -s -- --ui

# 装完自动配置所有 Agent,重启即可
# 可视化: localhost:9749

单静态二进制,macOS/Linux/Windows 全支持,零运行时依赖。

安全第一

安全与可信

100% 本地处理

代码从不离开你的机器。

SLSA Level 3

供应链安全最高等级之一。

签名 + 校验

每个 release 二进制签名 + checksum。

VirusTotal 扫描

70+ 杀毒引擎扫描每个版本。

适用场景

适合谁用

风险提示

需要权衡

潜力评估

未来空间

极致性能的代码理解方案。差异化极强:纯 C 单文件、毫秒级索引、120x token 节省、arXiv 论文背书、SLSA 3 安全等级。随着 AI Agent 深度介入大型代码库,"代码知识图谱"成为刚需基础设施。它的护城河是工程极致性——别人很难在性能上追平。若 MCP 生态成熟,这是 Agent 代码理解层的强力竞争者。


上一个
Claude-Mem
下一个
Context-Mode
1 / 13