Codegraph: 開発者とエージェントのためのAI駆動のコードインテリジェンス
Codegraphは、コードベースを解析し、ローカルナレッジグラフを構築するために設計されたMCPサーバーです。Colby McHenryによって開発されたこの無料ツールは、TypeScriptで構築されており、独自のNode.jsランタイム（Node ≥22.5）を含んでいます。Claude CodeやGemini CLIなどのさまざまなAIコーディングエージェントと統合されており、コードベースの理解と相互作用を向上させる機能を提供します。Codegraphは、効率的なクエリのためにFTS5フルテキスト検索を提供するローカルSQLiteデータベースにグラフデータを保存します。AIエージェントのワークフローを加速し、開発者の生産性を向上させることを目指しています。
Codegraphは何に接続しますか？
Codegraphは、コードベースと統合するMCPサーバーとして機能し、その構造を解析してローカライズされた知識グラフを生成します。このエンティティと関係のグラフは、ローカルSQLiteデータベース内に保存され、具体的には「.codegraph/codegraph.db」にあります。このデータベースは、効率的なデータ取得のためにFTS5フルテキスト検索を利用しています。互換性のあるAIクライアントは、ローカル操作のためにstdioを介して、またはリモート/共有デプロイメントのためにHTTPを介して接続し、SSE通知を受け取ります。サーバーは、Claude Code、Cursor、Codex CLI、OpenCode、Hermes Agent、Gemini CLI、Antigravity IDE、Kiroなど、さまざまなAIクライアントをサポートしています。
コア機能とツール
Codegraphは、コードベースと対話するためのいくつかの呼び出し可能なツールを公開しています。indexツールは、エンティティと関係の知識グラフを構築します。list_file_entitiesは、指定されたファイル内のすべてのエンティティのリストを提供し、「path」文字列が必要です。list_entity_relationshipsは、指定されたエンティティの関係を詳細に説明し、「path」と「name」文字列を使用します。codegraph_contextツールは、コードベースの特定の領域をマッピングします。さらに、codegraph_exploreは、シンボルとその相互接続を調査することを可能にします。これらのツールは、開発者とAIエージェントの両方がコード構造を深く理解するのを助けます。
誰のためのものですか？
Codegraphは、主にClaude Code、Cursor、Gemini CLIなどのAIコーディングエージェントや人間の開発者を対象としています。構造化されたコードベースの理解を提供することでエージェントの能力を向上させ、探索ラウンドを減少させ、トークン消費を低下させます。開発者は、変更の影響を評価し、大規模なコードベースを効率的にナビゲートする能力から恩恵を受けます。このツールは、外部APIキーなしでローカルで操作できるため、データプライバシーを優先する環境に適しています。管理されたインフラストラクチャを持つクラウドホスティングのコードインテリジェンスソリューションが主なニーズである場合は、これをスキップしてください。
始め方
Codegraphのコアローカル機能には、資格情報は必要ありません。リモートHTTPデプロイメントの場合、HARNESS_MCP_AUTH_TOKENやx-harness-api-keyなどの認証トークンを使用できます。
ユースケース
- 大規模なコードベースのナビゲーション：AIエージェントがエントリーポイントや呼び出しチェーンを迅速に特定するのを助け、広範なファイルスキャンの必要性を減少させます。
- 変更の影響評価：開発者とエージェントが、コード変更を実装する前に呼び出し元、呼び出し先、および任意のシンボルの完全な影響範囲を追跡できるようにします。
- AIエージェントの加速とコンテキスト構築：AIエージェントに構造化されたコードベースの理解を提供し、探索ラウンドを減少させ、トークン消費を低下させます。
Codegraphは、開発者とAIエージェントの両方にサービスを提供する、ローカルでグラフベースのコードインテリジェンスアプローチを提供します。これは、コードの理解を向上させ、エージェントのワークフローを加速し、外部サービスに依存することなく影響分析を助けます。このツールの正確で関連性のあるコードコンテキストを提供する能力は、開発効率を大幅に向上させることができます。
