codebase-memory-mcp代码库知识图谱工具

系统介绍

codebase-memory-mcp 是一款面向AI编程助手的极速代码分析后端，它通过 tree-sitter AST 解析与混合 LSP 语义类型解析，将整个代码仓库转化为持久化的知识图谱。该图谱包含函数、类、调用链、HTTP 路由、跨服务链接等结构化信息，使得 AI 助手能够以极少的 token 消耗快速理解大型代码库的架构。与传统逐文件搜索方式相比，五次结构化查询仅需约 3,400 tokens，而传统方式需要约 412,000 tokens，token 消耗降低 99.2%。

本工具以单一静态二进制文件形式分发，支持 macOS、Linux 和 Windows 平台，无需安装 Docker、无需运行时依赖、无需 API 密钥，真正做到即下即用。它通过 MCP（Model Context Protocol）协议与 Claude Code、Codex CLI、Gemini CLI 等主流 AI 编程助手集成，提供 14 个内置工具用于图谱查询与代码检索。无论是个人开发者还是大型团队，都能借助此引擎显著提升代码理解与重构效率。

核心功能

• 极速索引：采用 RAM-first 流水线，集成 LZ4 压缩、内存 SQLite 与 Aho-Corasick 匹配算法，Linux 内核（2800 万行、7.5 万文件）仅需 3 分钟即可完成全量索引，索引后内存自动释放。

• 即插即用：单一静态二进制支持全平台，下载后执行 install 命令即可完成安装，重启 AI 助手即可使用，无需配置环境或依赖管理。

• 158 种语言支持：所有 tree-sitter 语法文件已编译进二进制，开箱即用，不会因外部依赖损坏。其中 9 种语言享有完整的 Hybrid LSP 语义类型解析，识别精度更高。

• 多维搜索：内置语义向量搜索（Nomic 嵌入）、BM25 全文搜索（FTS5 + camelCase 分词）、结构化图搜索以及图增强 grep，覆盖全场景代码检索需求，精准定位目标代码片段。

• 跨服务链接：自动识别 HTTP 路由与调用点、gRPC/GraphQL/tRPC 服务，以及 Socket.IO 等 8 种语言的频道通信，帮助开发者理解微服务架构中的依赖关系。

• 安全可信：100% 本地处理，代码不离开机器。每个发布二进制均经过 VirusTotal 70+ 引擎扫描、SLSA Level 3 构建溯源、Sigstore 签名与 SHA-256 校验，确保供应链安全。

技术特性

codebase-memory-mcp 采用 Rust 语言开发，充分利用其零成本抽象与内存安全特性，实现亚毫秒级查询性能。核心引擎基于 tree-sitter 库构建，使用 WASM 编译的语法文件嵌入至单一二进制中，避免了系统级依赖。数据存储采用 SQLite 数据库，并通过 LZ4 压缩算法优化内存占用，索引过程采用流水线并行处理，大幅提升索引速度。整个架构为无服务端设计，AI 助手通过 MCP 协议直接调用本地引擎，无需部署后端服务，既保证了低延迟也保护了代码隐私。

此外，引擎支持多种索引模式：完整索引、增量索引和按需索引，用户可根据项目规模灵活选择。内置的图查询语言支持跨文件符号跳转、调用链追踪和路由拓扑分析，为开发者提供前所未有的代码洞察能力。

运营管理

codebase-memory-mcp 的运行管理非常简单。用户可通过命令行参数或配置文件调整引擎行为，例如设置索引路径、排除目录、选择语言解析器、配置缓存大小等。集成的 MCP 工具提供日志输出与状态监控，方便开发者追踪索引进度和查询性能。对于团队协作场景，可将配置统一为项目级配置文件，确保所有成员使用一致的索引策略。引擎还支持增量更新，当代码仓库发生变更时，仅需扫描变更部分即可更新知识图谱，极大降低维护成本。

使用说明

压缩包内有搭建教程。

图片演示