Codegraphcontext

🚀 CodeGraphContext

CodeGraphContext 是一个 MCP 服务器，它可以将本地代码索引到图数据库中，为 AI 助手提供上下文信息。

🚀 快速开始

安装步骤

• 安装：pip install codegraphcontext
• 配置：cgc setup
• 启动：cgc start
• 索引代码：cgc tool add-code-to-graph '{"path": "/path/to/your/project"}'

MCP 客户端配置

将以下内容添加到你的 MCP 客户端配置中：

{
  "mcpServers": {
    "CodeGraphContext": {
      "command": "cgc",
      "args": [
        "start"
      ],
      "env": {
        "NEO4J_URI": "************",
        "NEO4J_USER": "************",
        "NEO4J_PASSWORD": "**************"
      },
      "tools": {
        "alwaysAllow": [
          "list_imports",
          "add_code_to_graph",
          "add_package_to_graph",
          "check_job_status",
          "list_jobs",
          "find_code",
          "analyze_code_relationships",
          "watch_directory",
          "find_dead_code",
          "execute_cypher_query"
        ],
        "disabled": false
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

✨ 主要特性

• 代码索引：分析 Python 代码并构建其组件的知识图谱。
• 关系分析：查询调用者、被调用者、类层次结构等信息。
• 实时更新：监控本地文件的变化并自动更新图谱。
• 交互式设置：通过用户友好的命令行向导轻松完成设置。

💻 使用示例

自然语言交互示例

服务器启动后，你可以通过 AI 助手使用自然语言与其进行交互。以下是一些示例：

索引和监控文件

• 索引新项目：

  • “请对 /path/to/my-project 目录下的代码进行索引。” 或者
  • “将 ~/dev/my-other-project 项目添加到代码图谱中。”

• 开始监控目录的实时变化：

  • “监控 /path/to/my-active-project 目录的变化。” 或者
  • “实时更新我正在开发的 ~/dev/main-app 项目的代码图谱。”

当你要求监控一个目录时，系统会同时执行两个操作：

1. 启动全面扫描以索引该目录下的所有代码。此过程在后台运行，你将获得一个 job_id 来跟踪其进度。
2. 开始监控目录中的文件更改，以实时更新图谱。

这意味着你只需告诉系统监控一个目录，它就会自动处理初始索引和持续更新。

查询和理解代码

• 查找代码定义位置：

  • “process_payment 函数在哪里定义？”
  • “帮我找到 User 类。”
  • “显示与 '数据库连接' 相关的所有代码。”

• 分析关系和影响：

  • “哪些其他函数调用了 get_user_by_id 函数？”
  • “如果我修改 calculate_tax 函数，代码的哪些其他部分会受到影响？”
  • “显示 BaseController 类的继承层次结构。”
  • “Order 类有哪些方法？”

• 探索依赖关系：

  • “哪些文件导入了 requests 库？”
  • “查找 render 方法的所有实现。”

• 代码质量和维护：

  • “这个项目中是否有未使用的代码？”