DeusData GitHub avatar

codebase-memory-mcp

C
代码知识图谱工具DeusData最近推送 2026年11月20日
MCP 与工具接入MIT48.9k4,065581 issues7 天 +321

AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月17日

本地代码知识图谱 MCP 服务器,为 AI 代理提供代码结构上下文。

codebase-memory-mcp 是一个用 C 编写的 MCP 服务器,将代码、文档、配置和基础设施连接成持久化的本地知识图谱。它通过 17 个 MCP 工具向 AI 代理提供结构化上下文,并附带可选的 CBM Lens 可视化工具(开放测试版)。索引和查询无需托管服务或 API 密钥。

推荐指数

4.0

适合需要给 AI 代理提供代码结构上下文的开发者,本地运行、无需 API 密钥,但可视化组件尚在测试阶段。

近 7 天

+321

新增 Star

总 Star 排名

#116

雷达追踪的 3,971 个 AI 仓库中

创建于

2026

2026年2月25日

核心亮点

  • 1本地知识图谱

    代码、文档、配置和基础设施统一索引到本地持久化图谱,无需云端服务。

  • 217 个 MCP 工具

    通过 Model Context Protocol 向 AI 代理暴露符号搜索、调用关系、依赖查询等能力。

  • 3多语言支持

    内置语法解析支持 164 种语言和文件格式,并支持 Hybrid LSP 类型解析。

  • 4变更感知测试

    可评估代码变更影响范围,辅助选择需要运行的测试。

  • 5CBM Lens 可视化

    提供架构图、Galaxy 3D 图谱、源码阅读和本地代码问答,目前为开放测试版。

适用场景

  • AI 代理理解大型代码库

    例如:让 Claude Code 通过 MCP 查询某个函数的调用者和依赖,而不是反复读取文件。

  • 追踪跨服务调用

    例如:沿着调用链从入口函数追踪到下游服务,定位功能实现位置。

  • 评估变更影响

    例如:修改一个模块前,查询哪些文件和测试可能受影响。

  • 可视化代码结构

    例如:用 CBM Lens 查看目录架构图和符号关系图,快速熟悉陌生项目。

它是怎么工作的

  1. 第 1 步

    索引代码库

    使用内置语法解析器分析源码、文档和配置文件,提取符号和关系。

  2. 第 2 步

    构建知识图谱

    将提取的实体和关系存入本地持久化图数据库(基于 SQLite)。

  3. 第 3 步

    暴露 MCP 工具

    通过 MCP 协议向 AI 代理提供 17 个查询工具,支持符号搜索、调用链、依赖分析等。

  4. 第 4 步

    代理查询

    AI 代理在编码过程中调用 MCP 工具获取结构化上下文,减少重复文件读取。

  5. 第 5 步

    可视化与交互

    可选启动 CBM Lens 查看架构图、3D 图谱,或进行本地代码问答。

快速上手

  1. 1

    安装

    从 GitHub Releases 下载对应平台(macOS/Linux/Windows)的二进制文件。

  2. 2

    配置客户端

    运行安装器,选择要集成的 AI 客户端(如 Claude Code、Cursor 等),自动写入配置。

  3. 3

    索引仓库

    通过 CLI 或 MCP 工具触发对目标代码库的索引。

  4. 4

    开始查询

    在 AI 代理中通过 MCP 工具查询代码结构,或启动 CBM Lens 可视化浏览。

适合谁

  • 使用 AI 编码代理(如 Claude Code、Cursor)的开发者
  • 需要理解大型或陌生代码库的研发团队
  • 希望本地运行、避免代码外传的团队
  • 需要评估代码变更影响范围的工程师

不太适合

  • 不需要 AI 代理辅助编码的开发者
  • 仅处理小型项目、无需结构化查询的场景
  • 要求可视化工具完全稳定的生产环境

成熟度

  • 活跃度最近推送在 2026 年 11 月,star 数超过 4.8 万,活跃度高。
  • 文档README 详细,包含快速开始、功能说明和截图,但部分链接指向内部锚点。
  • 社区有 Discord 社区和 4047 个 fork,开放 issue 570 个,社区规模较大。
  • 上手难度提供安装器和 46 种客户端集成,但需要配置 MCP 客户端,对非 AI 代理用户门槛较高。

使用前注意

  • · CBM Lens 可视化组件处于开放测试阶段(v0.0.1),功能可能不稳定。
  • · 索引和查询在本地运行,大型代码库可能占用较多磁盘和内存资源。
  • · 需要 AI 客户端支持 MCP 协议才能发挥核心功能。
  • · MIT 许可证,可自由使用和修改。

主题标签

claude-codecode-analysiscode-intelligencedeveloper-toolsknowledge-graphmcpmcp-servermodel-context-protocolsqlitetree-sittercodexcursorwindsurfaidergemini-cligraph-visualizationkilocodeopencodeastcypher