工具 / CodeGraph

CodeGraph

  • mcp
  • agent
  • knowledge-base

本地代码知识图谱,预索引符号关系供 AI agent 通过 MCP 直接查询

CodeGraph 用 tree-sitter 把代码库解析成符号、调用边和文件结构,存入本地 SQLite 数据库(FTS5 全文索引),再通过 MCP server 暴露给 Claude Code、Cursor、Codex、OpenCode、Hermes Agent、Gemini、Antigravity、Kiro 等编码 agent。agent 不再需要用 grep/glob/Read 反复扫描文件来理解代码结构,改为直接查询知识图谱获取入口点、相关符号和代码片段。索引随文件变更自动增量更新(基于 FSEvents/inotify/ReadDirectoryChangesW 原生事件,2 秒防抖窗口),无需手动重建。完全本地运行,不依赖外部 API 或云服务。支持 20+ 种语言和 17 个 Web 框架的路由识别,还能跨语言桥接 iOS/React Native 的 Swift↔ObjC、原生模块与 JS 之间的调用关系。

社区实测

社区认为 CodeGraph 是 AI 编码 agent 的实用代码地图,在大中型仓库中能减少探索阶段的 token 消耗,但索引质量受项目结构影响,小项目优势不明显。

  • 为 AI 编码 agent 提供预索引的代码知识图谱,减少每次会话重复扫描文件的 token 开销
  • 支持 20+ 语言和 17 个 Web 框架,覆盖多语言仓库和全栈项目的代码导航需求
  • 完全本地运行,无需 API key 或外部服务,适合企业项目和私有仓库
  • 索引质量受项目结构影响,复杂结构、大量生成代码或未忽略的构建产物可能导致索引噪声
  • 在小项目(几十个文件)中优势不明显,常规搜索即可满足需求
  • 如果 agent 忽略 MCP 工具仍直接读取大量文件,预索引反而成为额外开销

截至 2026-06-19

curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh

← 返回工具列表