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

引言

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

Turn code repositories into a queryable graph for AI agents.

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

A powerful MCP server and CLI toolkit that indexes local code into a graph database to provide context to AI assistants and developers. Use it as a standalone CLI for comprehensive code analysis or connect it to your favorite AI IDE via MCP for AI-powered code understanding.

核心特性

• 代码索引： 分析代码并构建其组件的知识图谱。

  Code Indexing: Analyzes code and builds a knowledge graph of its components.

• 关系分析： 查询调用者、被调用者、类层次结构、调用链等。

  Relationship Analysis: Query for callers, callees, class hierarchies, call chains and more.

• 预索引包： 使用 .cgc 包即时加载知名仓库，无需索引！

  Pre-indexed Bundles: Load famous repositories instantly with .cgc bundles - no indexing required!

• 实时文件监控： 监控目录变更并自动实时更新图谱 (cgc watch)。

  Live File Watching: Watch directories for changes and automatically update the graph in real-time (cgc watch).

• 双模式运行： 既可作为开发者使用的独立 CLI 工具包，也可作为AI代理的 MCP 服务器。

  Dual Mode: Works as a standalone CLI toolkit for developers and as an MCP server for AI agents.

• 多语言支持： 完整支持14种编程语言。

  Multi-Language Support: Full support for 14 programming languages.

• 灵活的数据库后端： 支持 KùzuDB（Windows默认）、FalkorDB Lite（Unix典型嵌入式默认）、FalkorDB Remote 或 Neo4j。

  Flexible Database Backend: KùzuDB (default on Windows), FalkorDB Lite (typical embedded default on Unix when installed), FalkorDB Remote, or Neo4j (all platforms via Docker/native).

支持的编程语言

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

每种语言的解析器都会提取函数、类、方法、参数、继承关系、函数调用和导入语句，以构建一个全面的代码图谱将代码元素（如函数、类、方法）及其关系（如调用、继承）表示为图结构的数据模型。。

Each language parser extracts functions, classes, methods, parameters, inheritance relationships, function calls, and imports to build a comprehensive code graph.

数据库选项对比

CodeGraphContext 支持多种图数据库以图结构存储和查询数据的数据库系统，擅长处理实体间的关系和连接。后端以适应不同环境：

快速开始

安装核心工具包

pip install codegraphcontext

理解 CodeGraphContext 的两种模式

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

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

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

• 直接从终端索引和分析代码库
• 查询代码关系、查找死代码、分析复杂度
• 可视化代码图谱将代码元素（如函数、类、方法）及其关系（如调用、继承）表示为图结构的数据模型。和依赖关系
• 适合希望通过CLI命令直接控制的开发者

Use CodeGraphContext as a powerful command-line toolkit for code analysis:

• Index and analyze codebases directly from your terminal
• Query code relationships, find dead code, analyze complexity
• Visualize code graphs and dependencies
• Perfect for developers who want direct control via CLI commands

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

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

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

Use CodeGraphContext as an MCP server for AI assistants:

• Connect to AI IDEs (VS Code, Cursor, Windsurf, Claude, Kiro, etc.)
• Let AI agents query your codebase using natural language
• Automatic code understanding and relationship analysis
• Perfect for AI-assisted development workflows

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

You can use both modes! Install once, then use CLI commands directly OR connect to your AI assistant.

安装步骤 (两种模式)

1. 安装： pip install codegraphcontext

2. 数据库设置 (自动)

   • KùzuDB (Windows默认)： 在Windows、macOS和Linux上原生运行。在Windows上是常见的嵌入式选择；需要时运行 pip install kuzu。

     KùzuDB (default on Windows): Runs natively on Windows, macOS, and Linux. On Windows it is the usual embedded choice; pip install kuzu if needed.

   • FalkorDB Lite (Unix典型默认)： 在Unix/macOS/WSL上，当Python 3.12+且falkordblite可用时，嵌入式后端优先使用FalkorDB Lite；否则使用KùzuDB。

     FalkorDB Lite (typical default on Unix): When Python 3.12+ and falkordblite are available on Unix/macOS/WSL, the embedded backend prefers FalkorDB Lite; otherwise KùzuDB is used.

   • Neo4j (替代方案)： 如需使用Neo4j，或...

     Neo4j (Alternative): To use Neo4j instead, or...

常见问题（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适合企业级大规模图谱。