Provides tools for managing GitHub pull request review threads, including listing review comments, replying to threads, resolving discussions, and performing combined reply-and-resolve operations through GitHub's GraphQL API.
PR Review MCP Server
GitHub PR レビューコメントを取得・応答・解決するためのMCPサーバーです。
機能
このMCPサーバーは以下の4つのツールを提供します:
list_review_threads - PRのレビュースレッド一覧を取得
reply_to_review_thread - レビュースレッドに返信
resolve_review_thread - レビュースレッドを解決
reply_and_resolve - 返信と解決を一度に実行
前提条件
GitHub CLI (gh) がインストールされ、認証済みであること
gh auth loginuv (Python 3.10以上)
インストール
uvを使用する方法(推奨)
従来のpipを使用する方法
MCPクライアントでの使用
Claude Desktopの設定
uvを使用する場合(推奨)
~/.config/Claude/claude_desktop_config.json (Linux):
python3を使用する場合
使用例
1. レビュースレッド一覧の取得
2. レビューコメントに返信
3. レビュースレッドの解決
4. 返信と解決を一度に実行
ツールの詳細
list_review_threads
PRのレビュースレッド一覧を取得します。
パラメータ:
owner(string, 必須): リポジトリオーナーrepo(string, 必須): リポジトリ名pull_number(integer, 必須): PR番号unresolved_only(boolean, オプション): 未解決のみ取得 (デフォルト: true)
出力例:
reply_to_review_thread
レビュースレッドに返信を追加します。
パラメータ:
owner(string, 必須): リポジトリオーナーrepo(string, 必須): リポジトリ名pull_number(integer, 必須): PR番号thread_id(string, 必須): スレッドIDbody(string, 必須): 返信内容(Markdownサポート)
resolve_review_thread
レビュースレッドを解決済みとしてマークします。
パラメータ:
thread_id(string, 必須): スレッドID
reply_and_resolve
レビュースレッドに返信し、即座に解決します。
パラメータ:
owner(string, 必須): リポジトリオーナーrepo(string, 必須): リポジトリ名pull_number(integer, 必須): PR番号thread_id(string, 必須): スレッドIDbody(string, 必須): 返信内容(Markdownサポート)
技術詳細
このMCPサーバーは以下の技術を使用しています:
GitHub GraphQL API: レビュースレッドの取得と操作
gh CLI: GitHub APIへのアクセス(認証を含む)
MCP (Model Context Protocol): AIアシスタントとの統合
GraphQL APIの使用
このサーバーは主に以下のGraphQL操作を使用します:
クエリ:
repository.pullRequest.reviewThreads- レビュースレッド取得ミューテーション:
addPullRequestReviewThreadReply- 返信追加ミューテーション:
resolveReviewThread- スレッド解決
トラブルシューティング
gh command failed エラー
gh CLIが正しくインストール・認証されているか確認してください:
認証されていない場合:
Pull request not found エラー
リポジトリ名、オーナー、PR番号が正しいか確認
PRが実際に存在するか確認
ghコマンドで該当リポジトリにアクセス権限があるか確認
GraphQL errors エラー
thread_idが正しいか確認(
list_review_threadsで取得したIDを使用)PR番号が正しいか確認
リポジトリへの書き込み権限があるか確認
ライセンス
このプロジェクトはMITライセンスの下で公開されています。
開発
依存関係の管理
コード品質チェック
テストの実行
CI/CD
このプロジェクトはGitHub Actionsを使用した自動CI/CDパイプラインを備えています。
ワークフロー
CI/CD(.github/workflows/ci.yml)
プッシュとプルリクエストで自動実行されます:
Lint: Ruffによるコードのリント
Format Check: Ruffによるフォーマットチェック
Test: Python 3.10、3.11、3.12での自動テスト
Release(.github/workflows/release.yml)
バージョンタグがプッシュされた時に自動実行されます:
このワークフローは:
パッケージをビルド
GitHub Releaseを作成
(オプション)PyPIに公開
Dependabot(.github/dependabot.yml)
依存関係の自動更新:
GitHub Actionsの更新(週次)
Python依存関係の更新(週次)