DeusData/codebase-memory-mcp

High-performance code intelligence MCP server. Indexes codebases into a persistent knowledge graph — average repo in milliseconds. 158 languages, sub-ms queries, 99% fewer tokens. Single static binary, zero dependencies.

codebase-memory-mcp – 面向 AI 编码助手的快速本地代码智能引擎

是什么 – 一个原生、零运行时的可执行文件，使用 Tree-sitter 解析器为 158 种语言 构建持久的代码库知识图谱（函数、类、调用链、HTTP 路由、基础设施文件等）。该图谱可在毫秒级响应查询，专为 AI 驱动的编码助手（Claude Code、Codex、OpenCode 等）设计，使其无需将源文件发送到远程服务即可回答结构化问题。

为何重要 – 传统基于 LLM 的代码工具逐个扫描文件，速度慢且消耗大量 token。通过一次性索引仓库并暴露图谱，该工具将 token 预算减少约 120 倍，工具调用开销减少超过 2 倍，并能在不到 1 毫秒内回答“这个函数在哪里被使用？”或“这个变更会产生什么影响？”等复杂问题。

核心功能

功能	作用
闪电般快速索引	完整 Linux 内核（2800 万行代码，7.5 万个文件）在约 3 分钟内完成索引；典型仓库在数秒内完成。
混合 LSP 类型解析	使用轻量级 C 实现，对 Python、TS/JS、PHP、C#、Go、C/C++、Java、Kotlin、Rust、Perl 等 12 种主要语言进行深度语义分析，模拟主流语言服务器行为。
图谱与分析 API	支持函数、类、导入、调用边、HTTP 路由、gRPC/GraphQL 服务、事件通道边、未使用代码检测、社区检测（Louvain）、git 差异影响映射、ADR 管理等。
查询语言	• Cypher 风格：图谱上的模式匹配 • 语义搜索：使用内置 Nomic 代码嵌入（无需 API 密钥） • BM25 全文搜索：通过 SQLite FTS5 实现，支持 camelCase/snake_case 词元化 • 结构化/正则搜索：对节点标签进行搜索
内置 3D UI	启动本地 Web UI（`localhost:9749`），可视化跨一个或多个仓库的图谱。
跨仓库智能	节点可跨多个索引仓库链接，实现全团队架构视图。
零运行时，纯本地	无需 Docker、无需语言运行时、无需外部 API 密钥。所有处理均在开发者机器上完成。
代理集成	自动检测并配置 43 种支持的编码代理“表面”（如 Claude Code、Codex、OpenCode），通过向代理配置文件写入所需 MCP 条目实现。
包管理器分发	支持通过 npm、PyPI、Homebrew、Scoop、Winget、AUR 和 `go install` 安装。

典型工作流程

安装 – 一行脚本（macOS/Linux 上为 curl … | bash，Windows 上为 PowerShell 脚本）下载已验证的二进制文件和小型安装辅助工具。
索引 – 安装后，工具自动检测你的编码代理；你向代理发出“索引此项目”命令。守护进程构建图谱并存储在 ~/.cache/codebase-memory-mcp/ 下。
查询 – 通过代理或 CLI 执行 search_graph、detect_changes 或自定义 Cypher 查询。代理现在可即时回答结构化问题。
可视化 – 运行 codebase-memory-mcp --ui=true --port=9749 在浏览器中探索图谱。
更新 / 卸载 – 同一安装脚本处理升级；codebase-memory-mcp uninstall 清理配置条目和可选索引。

适合谁使用

依赖基于 LLM 的编码助手，希望获得关于自己代码的确定性、低延迟回答的 开发者。
需要共享、版本控制的代码库表示的团队（可将 .codebase-memory/graph.db.zst 资产提交以避免重新索引）。
探索基于代码图谱的提示或 LLM 工具调用策略的 研究人员。

限制与注意事项

纯本地 – 无云服务；必须在每台需要图谱的机器上运行二进制文件。
初始索引成本 – 首次完整索引可能内存密集（内存中 SQLite，LZ4 压缩），但完成后会释放内存。
误报杀毒软件警告 – 某些扫描器（如 Microsoft Defender）会标记二进制文件；项目提供哈希值和 VirusTotal 扫描以验证完整性。
支持语言 – 虽然捆绑了 158 个语法，但深度语义类型解析（混合 LSP）仅限于列出的 12 种语言。
代理兼容性 – 43 种列出的代理可开箱即用；其他工具可能需要手动配置 MCP 条目。

快速入门片段

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash
# Windows (PowerShell)
Invoke-WebRequest -Uri https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.ps1 -OutFile install.ps1
notepad install.ps1   # 可选检查
Unblock-File .\install.ps1
.\install.ps1

安装后，重启你的编码助手并发出“索引此项目”命令。