TypeScript本月中等

colbymchenry/codegraph

本地生成代码知识图谱，帮AI工具更高效读代码

这是一款本地运行的代码知识图谱工具，为Claude Code、Cursor等多款AI代码工具提供预索引的语义代码信息，可减少token消耗与工具调用次数，同时保障代码隐私安全。

Stars

45.8k

Forks

2,809

增长

+43.7k（this month）

在 GitHub 打开

Overview

项目介绍

colbymchenry/codegraph 是一个偏实用的Agent 基础设施，瞄准的问题很具体：本地生成代码知识图谱，帮AI工具更高效读代码。它关注的是运行环境、沙箱、操作接口和执行链路这些更底层的能力，让它从“能跑的示例”更接近可以接进真实流程的工程模块。

从实现侧看，100%本地运行，保障代码隐私、适配多款主流AI代码工具和大幅降低token使用成本是它目前最值得看的部分。它更像一个能承担具体工序的组件，适合先放进开发者借助AI工具解读复杂代码和团队协作时统一AI代码分析标准里小范围试跑，再判断能否扩展到完整链路。

Technical Route

技术路线

CodeGraph 以本地 SQLite 数据库为存储核心，先通过 CLI 完成多 AI 代码工具的自动配置接入，再对目标代码库进行语义扫描构建预索引知识图谱，最后通过 MCP（模型配置协议）服务器向 AI 工具提供查询接口。用户理解此路线可明确本地数据隐私保障逻辑，以及如何通过预索引减少 AI 工具的文件扫描与 Token 消耗，提升代码查询效率。

1CLI 部署适配层：提供跨平台一键安装脚本，无需 Node.js 依赖即可部署，支持通过 npm 全局安装或直接运行二进制包，安装后自动完成 Claude Code、Cursor 等 8 款 AI 代码工具的 MCP 服务器配置，实现无缝接入。
2语义索引构建层：通过 `codegraph init -i` 命令触发代码库扫描，支持 20+ 编程语言，识别符号关系、调用图及框架路由，将语义数据存储至本地 SQLite 数据库，生成 `.codegraph/` 索引目录。
3MCP 服务交互层：启动 MCP（模型配置协议）服务器，对接 AI 工具的查询请求，通过 `codegraph_explore` 接口返回预索引的代码语义信息，替代 AI 工具原生的 grep、文件读取等工具调用，减少 Token 消耗与查询时间。
4实时同步维护层：基于原生 OS 事件（FSEvents/inotify/ReadDirectoryChangesW）实现文件监听，通过防抖机制触发自动重索引，同步周期可通过 `CODEGRAPH_WATCH_DEBOUNCE_MS` 调整，确保索引与代码实时一致。
5stale 状态处理层：在索引同步窗口期，针对未更新的文件，MCP 服务器会在响应中添加警告横幅，引导 AI 工具直接读取文件内容，避免返回过期信息，保障查询准确性。
6全量能力扩展层：支持全文本搜索（基于 FTS5）、调用链路追踪、跨语言关联分析（如 Swift ↔ Objective-C 桥接），后续将推出 CodeGraph Platform，提供 PR 影响分析等进阶能力。

Why Trending

为什么它会上榜

结合增长、最近更新与社区关注，给出一个更接近“决策参考”的上榜解读。

社区关注度上升：近期新增 +43749 Stars（this month），讨论热度明显提高。
定位清晰：为多款AI代码工具预构建本地代码知识图谱，大幅减少token消耗与工具调用次数，提升AI读代码效率

Audience

适合谁

使用AI代码工具解读复杂项目的独立开发者
需要统一AI代码分析标准的中小型技术团队
关注代码隐私、不愿将代码上传至第三方平台的开发者
经常进行大型代码库架构分析的技术负责人

Use Cases

能拿来做什么

开发者借助AI工具解读复杂代码
团队协作时统一AI代码分析标准

Quick Start

怎么开始

请看仓库README的安装章节

Watchouts

使用前注意事项

安装CLI后需重启终端才能生效，否则可能出现命令无法识别的问题。
虽然工具本地运行保障隐私，但配置对接AI工具时会修改工具的MCP服务器设置，卸载时需使用官方命令彻底清除配置。
目前仅支持指定的8款AI代码工具，未适配的其他工具无法直接对接使用。