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 方法的所有實現。”

• 代碼質量和維護：

  • “這個項目中是否有未使用的代碼？”