CodeGraph语义代码知识图谱源码

文章正文

这份工具源码属于 AI 编程辅助方向，核心是用 tree-sitter 把项目源码解析成跨语言的语义知识图谱，再通过 MCP 接口提供给 Claude Code、Cursor、Codex 等代理调用。
它完全在本地运行，不依赖任何外部服务，适合想研究代码智能、静态分析或给自家代理接上下文引擎的开发者学习参考。
从 README 与 src 目录结构看，项目功能完整、模块划分清晰，是可以直接阅读与二次开发的真实工程。

源码简介

CodeGraph（npm 包 @colbymchenry/codegraph）是一款面向 AI 编程代理的语义代码智能工具。
它通过 tree-sitter 抽取 TypeScript、Python、Go、Rust 等 30+ 语言的代码结构，在本地 SQLite 中构建可跨文件查询的知识图谱，并以单个 MCP 工具 codegraph_explore 对外提供服务。
工具完全本地运行，支持文件变更自动同步，适合学习代码智能、静态分析与 AI 代理上下文增强。

适用场景

• 给 Claude Code、Cursor、Codex 等 AI 编程代理接入精准的代码上下文，减少逐文件检索。
• 做跨语言、跨文件的调用关系与影响范围分析，例如 iOS 与 React Native 的桥接链路梳理。
• 研究 tree-sitter 静态分析、代码知识图谱或 MCP 工具开发的开发者学习参考。

技术栈与运行环境

• 前端：官方文档站点基于 Astro（site/ 目录），assets/languages 提供各语言图标。
• 后端：TypeScript / Node.js，CLI 加 MCP 服务器，tree-sitter WASM 做多语言解析。
• 数据库：本地 SQLite（FTS5 全文检索），索引存于项目内 .codegraph/ 目录。
• 运行环境：自带打包运行时，无需本机 Node。
• 其他依赖：commander、web-tree-sitter、@clack/prompts、picomatch、jsonc-parser 等（见 package.json）。

功能亮点

• 多语言语义抽取：内置 tree-sitter-*.wasm（20+ 语言），从文件扩展名自动识别，无需逐语言配置（src/extraction/wasm）。
• 单一 MCP 工具 codegraph_explore：一次调用返回相关符号源码、调用路径与影响范围，适配多种 AI 编程代理（src/mcp）。
• 跨文件与跨语言影响分析：追踪调用方、被调用方与影响半径，并桥接 Swift 与 ObjC、React Native、Expo 等跨语言链路。
• 文件变更自动同步：原生 FSEvents / inotify / ReadDirectoryChangesW 监听加防抖，让索引始终保持最新（src/sync）。
• 一键接入多类代理：installer 自动检测并写入 Claude Code、Cursor、Codex、opencode、Gemini、Kiro 等的 MCP 配置（src/installer/targets）。
• 100% 本地运行与可选遥测：数据不出本机，仅落本地 SQLite。
• 匿名使用统计在安装时询问，可用 codegraph telemetry off 随时关闭。

安装与部署提示

1. 安装 CLI：macOS / Linux 执行 install.sh 或 npm i -g @colbymchenry/codegraph，Windows 用 PowerShell 的 install.ps1，无需本机 Node。
2. 接入代理：运行 codegraph install 自动检测并配置已安装的 AI 编程代理，或用 npx @colbymchenry/codegraph 一步完成。
3. 初始化项目：进入目标仓库执行 codegraph init，会在 .codegraph/ 生成索引，之后随文件改动自动同步。
4. 在代理侧：重启 Claude Code / Cursor / Codex 等，使其加载 CodeGraph 的 MCP 服务后即可调用。

安全风险提示

特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！

中性补充说明：工具默认开启匿名遥测，仅统计命令与工具使用量、各语言索引量，不含代码、路径、文件名或查询内容，且安装时会询问、可随时 codegraph telemetry off 关闭。
源码 telemetry-worker 目录含公开的云端摄入端点实现，可自行查阅具体数据处理逻辑。

下载说明

源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。

GitHub开源地址：https://github.com/colbymchenry/codegraph