Codegraphcontext

🚀 CodeGraphContext

ローカルコードをグラフデータベースにインデックス化し、AIアシスタントにコンテキストを提供するMCPサーバーです。

✨ 主な機能

• コードインデックス化：Pythonコードを分析し、そのコンポーネントの知識グラフを構築します。
• 関係性分析：呼び出し元、呼び出し先、クラス階層などをクエリできます。
• ライブ更新：ローカルファイルの変更を監視し、自動的にグラフを更新します。
• 対話型セットアップ：使いやすいコマンドラインウィザードによる簡単なセットアップが可能です。

🚀 クイックスタート

1. インストール：pip install codegraphcontext
2. セットアップ：cgc setup
3. 起動：cgc start
4. コードのインデックス化：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": []
    }
  }
}

自然言語による対話例

サーバーが起動したら、AIアシスタントを通じて自然な英語で対話できます。以下にいくつかの例を示します。

ファイルのインデックス化と監視

• 新しいプロジェクトをインデックス化する場合

  • "Please index the code in the /path/to/my-project directory." または
  • "Add the project at ~/dev/my-other-project to the code graph."

• ディレクトリの変更をライブで監視する場合

  • "Watch the /path/to/my-active-project directory for changes." または
  • "Keep the code graph updated for the project I'm working on at ~/dev/main-app."

  ディレクトリの監視を要求すると、システムは2つのアクションを同時に実行します。

  1. そのディレクトリ内のすべてのコードをインデックス化するための完全なスキャンを開始します。このプロセスはバックグラウンドで実行され、進行状況を追跡するためのjob_idを受け取ります。
  2. ディレクトリ内のファイルの変更を監視し、グラフをリアルタイムで更新します。

  つまり、ディレクトリの監視を指示するだけで、初期のインデックス化と継続的な更新の両方を自動的に処理します。

コードの検索と理解

• コードの定義場所を検索する場合

  • "Where is the process_payment function?"
  • "Find the User class for me."
  • "Show me any code related to 'database connection'."

• 関係性と影響を分析する場合

  • "What other functions call the get_user_by_id function?"
  • "If I change the calculate_tax function, what other parts of the code will be affected?"
  • "Show me the inheritance hierarchy for the BaseController class."
  • "What methods does the Order class have?"

• 依存関係を探索する場合

  • "Which files import the requests library?"
  • "Find all implementations of the render method."

• コードの品質とメンテナンス

  • "Is there any dead or unused code in this project?"