code-review-graphとは?
code-review-graphは、tree-sitter でリポジトリを解析して関数、クラス、インポート、呼び出し、テストのグラフにし、ローカルのSQLiteファイルに保存して、MCPでAIコーディングツールに提供します。変更をレビューするとき、アシスタントはグラフに「影響範囲」(変更が触れうるすべての呼び出し元、依存先、テスト)を問い合わせ、そのファイルだけを読みます。フックとウォッチモードでグラフを差分更新し続けます。
公開しているのは30のMCPツールと5つのプロンプトで、影響分析やレビュー用のコンテキストから、実行フローの一覧、アーキテクチャの概要、リファクタリングのプレビュー、リポジトリ横断の検索までそろっています。CRG_TOOLSの設定で一覧を絞れます。1つのインストールコマンドで、Claude Code、Codex、Cursor、Windsurf、Zed、Gemini CLI、GitHub Copilotを含む16のAIツールを検出して設定します。GitHub Actionは、リスクスコア付きのレビューコメントをプルリクエストに投稿します。
リポジトリのGitHubスターは約32,300で、バージョン2.3.9は2026年9月18日に公開されました。MITライセンスで、Python 3.10以降が必要です。
code-review-graphのインストール方法
pip install code-review-graph && code-review-graph installcode-review-graphは使う価値があるか?
発想は妥当です。レビューのたびにアシスタントにコードベースの大部分を読み直させる代わりに、何が何に依存しているかを事前に計算し、短い一覧を渡します。READMEによると、6つのオープンソースリポジトリで、質問1件 あたりのトークンは中央値で63分の1に減り、最大のリポジトリであるfastapiでは最大358分の1でした。メンテナーの測定では、約3,000ファイルのリポジトリの初回構築に約40秒かかり、2ファイルの編集は約2.5秒で再インデックスされ、そのうち1.4秒はプロセスの起動です。
プロジェクトは自らの限界について率直で、これは本来もっとあってよいことです。影響の再現率1.0は循環的(正解データが同じグラフから来ている)だと述べ、平均F1は0.69、適合率は0.55と報告しています。同時変更の評価では使える結果が出なかったことを認め、ごく小さな編集ではグラフのコンテキストが普通にファイルを読むより高くつくことがあると注記し、フロー検出はPythonやPHPよりJavaScriptやGoで弱いとしています。
トレードオフは導入の広がりと制御です。インストール手順は、見つけたすべてのAIツールにMCPの登録、フック、スキル、ルールファイルへの指示を書き込みます。30のツール定義はかなりのコンテキストを消費します。プラットフォームごとのフラグとCRG_TOOLSで絞り込めます。ほとんどのツールは読み取りだけですが、apply_refactor_toolはソースファイルを編集します。初期状態ではすべてがローカルにとどまりますが、クラウドの埋め込みプロバイダーを有効にするとコードの断片がマシンの外に送られ、ツールはその点を警告します。未解決のissueが186件あり、9月18日以降リリースがないので、保守は止まっているわけではなく忙しい状態ですが、積み残しは多いです。
GitNexusと比べると、ライセンスが緩く(非商用ライセンスではなくMIT)、レビューに特化しています。Serenaと比べると、グラフが言語サーバーではなく構文解析から作られるため、精密な編集では劣ります。プレビューされるリネームは構造上の推測で、型チェックを経たものではありません。
真価を発揮する場面
Claude Codeを使う、3,000ファイルのPythonサービスのレビュアー
エージェントにリポジトリの半分を読ませずにプルリクエストをレビューする
code-review-graph installを一度実行します(この規模なら構築に約40秒)。エージェントはget_review_context_toolとget_impact_radius_toolを呼び出し、影響範囲にあるファイルだけを読みます。READMEの中央値では質問1件あたりのトークンが63分の1になりますが、2行の編集ではファイルを読むより高くつくことがあります。
すべてのプルリクエストでリスクの兆候を知りたいエンジニアリングマネージャー
CIで危険な変更とテストのないホットスポットを指摘する
複合GitHub Actionがランナー上でグラフを構築し、リスクスコア付きの関数、影響を受けるフロー、テストの不足をまとめた固定コメントを1つ投稿します。fail-on-riskを使えばマージの関門になります。コードはランナーの外に出ないため、費用はCIの実行時間だけです。
大規模で見慣れないPHPのコードベースに加わった開発者
何かに手を付ける前にアーキテクチャの全体図を得る
get_architecture_overview_toolとgenerate_wiki_toolが、検出したコードのコミュニティから全体像を作り、get_knowledge_gaps_toolがテストのないホットスポットを示します。フロー検出はJavaScriptやGoよりPythonやPHPで強いため、全体図が最も信頼できるのはこれらの言語です。
導入前に確認すること
- 導入
- pip install code-review-graphのあと、code-review-graph installを実行すると最大16のAIツールを検出し、それぞれにMCPの登録、フック、スキル、ルールの指示を書き込みます。その後エディタを再起動します。Python 3.10以降が必要で、code-review-graph uninstallは自分が書き込んだ項目だけを削除します。
- 連携
- 30のツールと、review_changesやpre_merge_checkなど5つのMCPプロンプトがあります。ほとんどは読み取り専用のクエリ(影響範囲、レビュー用コンテキスト、呼び出し元と呼び出し先、フロー、コミュニティ、ハブとブリッジのノード)です。build_or_update_graph_tool、embed_graph_tool、generate_wiki_tool、apply_refactor_toolは書き込みを行い、最後のものはソースファイルを書き換えます。
- データとプライバシー
- グラフはローカルのSQLiteファイルです。serveはstdioで動作し、serve --httpはlocalhost:5555で待ち受けます。任意のクラウド埋め込み(Gemini、Voyage、MiniMax、または任意のOpenAI互換エンドポイント)は、先に警告を出したうえでコードの断片をマシンの外に送ります。セキュリティアドバイザリは公開されていません。
- 大規模利用時のコスト
- 無料です。ローカルの埋め込みは初期状態でCPU上のall-MiniLM-L6-v2を使い、クラウドの埋め込みプロバイダーはそれぞれの料金で課金します。節約できるのはモデルの費用です。READMEのサンプルの質問では、コーパス全体ではなく約2,200〜3,900トークンが返ります。
- 制限
- プロジェクト自身の説明でも影響の再現率は循環的で、13のコミットでの平均F1は0.69です。読み取り専用ツールはCRG_TOOL_TIMEOUTを設定しない限りタイムアウトがなく、書き込みツールはこの設定でも制限されません。
良い点
- コードレビューに的を絞った影響範囲の分析
- ローカルのSQLiteグラフで、外部サービスが不要
- MITライセンスで、PRコメント用のGitHub Actionがある
- 自らのベンチマークの限界を文書化している
気になる点
- 30のツールは絞り込まないとコンテキストの負担になる
- インストーラーが検出したすべてのツールにフックとルールを書き込む
- フロー検出はJavaScriptとGoで弱い
- 未解決のissueが186件、2026年9月以降リリースがない
おすすめの人
中規模から大規模のリポジトリでプルリクエストのレビューにAIアシスタントを使い、緩いライセンスのローカルなコードグラフが欲しいチームです。
code-review-graphの代替
code-review-graph:よくある質問
- code-review-graphは使う価値があるか?
- 影響範囲を事前に計算しておくことで、大きなリポジトリでのAIレビューが安くなります。プロジェクトは自分たちの数字の弱点について珍しいほど率直です。インストール前に30のツールを絞り込んでください。 評価は5点満点中4.0点です。
- code-review-graphの料金は?
- 無料のオープンソース(MIT)です。任意で使うクラウドの埋め込みプロバイダー(Gemini、Voyage、OpenAI互換)は別途課金されます。
- code-review-graphの欠点は?
- 30のツールは絞り込まないとコンテキストの負担になる; インストーラーが検出したすべてのツールにフックとルールを書き込む; フロー検出はJavaScriptとGoで弱い; 未解決のissueが186件、2026年9月以降リリースがない.
- code-review-graphは誰に向いているか?
- 中規模から大規模のリポジトリでプルリクエストのレビューにAIアシスタントを使い、緩いライセンスのローカルなコードグラフが欲しいチームです。
- チームや本番環境でcode-review-graphを使うと費用はいくらか?
- 無料です。ローカルの埋め込みは初期状態でCPU上のall-MiniLM-L6-v2を使い、クラウドの埋め込みプロバイダーはそれぞれの料金で課金します。節約できるのはモデルの費用です。READMEのサンプルの質問では、コーパス全 体ではなく約2,200〜3,900トークンが返ります。
- code-review-graphは企業データを扱っても安全か?
- グラフはローカルのSQLiteファイルです。serveはstdioで動作し、serve --httpはlocalhost:5555で待ち受けます。任意のクラウド埋め込み(Gemini、Voyage、MiniMax、または任意のOpenAI互換エンドポイント)は、先に警告を出したうえでコードの断片をマシンの外に送ります。セキュリティアドバイザリは公開されていません。
- code-review-graphの代わりになるものは?
- 当サイトでレビューした中で最も近い代替はGitNexus, Serena, Semble, GitHub MCP Server 、 CodeGraphです。
回答確認日:2026年10月23日
