CodeGraphContext如何将代码仓库转化为AI可查询的知识图谱？

引言

将代码仓库转化为AI代理可查询的知识图谱。

CodeGraphContext 是一个强大的 MCP 服务器 和 CLI 工具包，它将本地代码索引到图数据库中，为AI助手和开发者提供上下文。您可以将其作为独立的CLI工具进行全面的代码分析，也可以通过MCP连接到您喜欢的AI IDE，实现AI驱动的代码理解。

核心特性

• 代码索引： 分析代码并构建其组件的知识图谱。
• 关系分析： 查询调用者、被调用者、类层次结构、调用链等。
• 预索引包： 使用 .cgc 包即时加载知名仓库，无需索引！
• 实时文件监控： 监控目录变更并自动实时更新图谱 (cgc watch)。
• 双模式运行： 既可作为开发者使用的独立 CLI 工具包，也可作为AI代理的 MCP 服务器。
• 多语言支持： 完整支持14种编程语言。
• 灵活的数据库后端： 支持 KùzuDB（Windows默认）、FalkorDB Lite（Unix典型嵌入式默认）、FalkorDB Remote 或 Neo4j。

支持的编程语言

CodeGraphContext 为以下语言提供全面的解析和分析：

每种语言的解析器都会提取函数、类、方法、参数、继承关系、函数调用和导入语句，以构建一个全面的代码图谱。

数据库选项对比

CodeGraphContext 支持多种图数据库后端以适应不同环境：

快速开始

安装核心工具包

pip install codegraphcontext

理解 CodeGraphContext 的两种模式

CodeGraphContext 以 两种模式 运行，您可以单独或同时使用它们：

🛠️ 模式一：CLI 工具包 (独立使用)

将 CodeGraphContext 用作强大的命令行工具包进行代码分析：

• 直接从终端索引和分析代码库
• 查询代码关系、查找死代码、分析复杂度
• 可视化代码图谱和依赖关系
• 适合希望通过CLI命令直接控制的开发者

🤖 模式二：MCP 服务器 (AI驱动)

将 CodeGraphContext 作为 MCP 服务器 供AI助手使用：

• 连接到AI IDE (VS Code, Cursor, Windsurf, Claude, Kiro等)
• 让AI代理使用自然语言查询您的代码库
• 自动进行代码理解和关系分析
• 适合AI辅助开发工作流

两种模式可以同时使用！ 安装一次后，即可直接使用CLI命令，或连接到您的AI助手。

安装步骤 (两种模式)

1. 安装： pip install codegraphcontext

2. 数据库设置 (自动)

   • KùzuDB (Windows默认)： 在Windows、macOS和Linux上原生运行。在Windows上是常见的嵌入式选择；需要时运行 pip install kuzu。
   • FalkorDB Lite (Unix典型默认)： 在Unix/macOS/WSL上，当Python 3.12+且falkordblite可用时，嵌入式后端优先使用FalkorDB Lite；否则使用KùzuDB。
   • Neo4j (替代方案)： 如需使用Neo4j，或...

常见问题（FAQ）

CodeGraphContext 支持哪些编程语言？

它完整支持14种编程语言，包括Python、JavaScript、TypeScript、Java、C/C++、C#、Go、Rust、Ruby、PHP、Swift、Kotlin、Dart和Perl。

CodeGraphContext 的两种运行模式是什么？

它可作为独立的CLI工具包供开发者进行代码分析，也可作为MCP服务器连接AI IDE（如Cursor、Windsurf），实现AI驱动的代码理解。

CodeGraphContext 支持哪些图数据库？如何选择？

支持KùzuDB（Windows默认）、FalkorDB Lite（Unix嵌入式默认）、FalkorDB Remote和Neo4j。KùzuDB适合本地开发，Neo4j适合企业级大规模图谱。