vitali87/code-graph-rag

这是什么？

核心功能

• 01将 Python、TypeScript、Rust、Go、Java、C/C++、C# 等多种语言统一解析到同一图谱结构中。
• 02通过生成 Cypher 查询，用自然语言回答代码库相关问题。
• 03按函数、类或方法名称或意图检索源码。
• 04基于 AST 进行代码修改，写入前提供 diff 预览。
• 05从入口点出发遍历调用和引用关系，查找死代码。
• 06可作为 MCP 服务运行，供 Claude Code 等客户端调用。

适用场景

• 接手大型 monorepo 时，快速了解模块和函数之间的调用关系。
• 让 Claude Code 等 AI 编程助手基于真实代码结构工作。
• 在清理代码前，检查混合语言项目中未被使用的函数。
• 跨多种语言进行基于 AST 模式的搜索和改写。

快速上手

1. 1

   使用 uv 从 PyPI 安装 cgr

   uv tool install "code-graph-rag[treesitter-full,ast-grep,semantic]"
2. 2

   将代码仓库索引到图中

   cgr start --repo-path /path/to/repo --update-graph
3. 3

   启动代理并针对已索引的代码仓库提问

   cgr start --repo-path /path/to/repo

使用前须知

• !需要预先安装 Python 3.12+ 和 ripgrep。
• !只有部分语言获得完整支持；Ruby、Kotlin、Swift、Elixir、Haskell、Solidity、Bash 和 Nix 仅有结构级支持。
• !查询和编辑依赖 AI 模型来生成 Cypher 查询并驱动代理。

标签

常见问题

code-graph-rag 是什么？

将多语言代码库解析为知识图谱，通过 AI 智能体或 MCP 服务用自然语言查询、检索和编辑代码。 Code-Graph-RAG 使用 Tree-sitter 解析代码仓库，将函数、类、方法、模块及其之间的关系构建为知识图谱。默认图数据存储在内嵌的 SQLite 文件中，无需数据库服务器；Memgraph 和 Neo4j 可作为可选后端。

code-graph-rag 可以免费使用吗？用的什么许可证？

code-graph-rag 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

code-graph-rag 还在维护吗？

活跃维护中。code-graph-rag 最近一次提交是在 2026年10月19日。

code-graph-rag 适合用来做什么？

接手大型 monorepo 时，快速了解模块和函数之间的调用关系。 让 Claude Code 等 AI 编程助手基于真实代码结构工作。 在清理代码前，检查混合语言项目中未被使用的函数。 跨多种语言进行基于 AST 模式的搜索和改写。

code-graph-rag 怎么安装和运行？

使用 uv 从 PyPI 安装 cgr: uv tool install "code-graph-rag[treesitter-full,ast-grep,semantic]" 将代码仓库索引到图中: cgr start --repo-path /path/to/repo --update-graph 启动代理并针对已索引的代码仓库提问: cgr start --repo-path /path/to/repo

在哪里获取 code-graph-rag？

源代码和安装说明在 GitHub 上：https://github.com/vitali87/code-graph-rag