PR Review MCP Server

# PR Review MCP Server [](https://github.com/UtakataKyosui/PR-Review-Resolve-MCP/actions/workflows/ci.yml) [](https://opensource.org/licenses/MIT) GitHub PR レビューコメントを取得・応答・解決するためのMCPサーバーです。 ## 機能 このMCPサーバーは以下の4つのツールを提供します： 1. **list_review_threads** - PRのレビュースレッド一覧を取得 2. **reply_to_review_thread** - レビュースレッドに返信 3. **resolve_review_thread** - レビュースレッドを解決 4. **reply_and_resolve** - 返信と解決を一度に実行 ## 前提条件 - [GitHub CLI (gh)](https://cli.github.com/) がインストールされ、認証済みであること ```bash gh auth login ``` - [uv](https://github.com/astral-sh/uv) (Python 3.10以上) ## インストール ### uvを使用する方法（推奨） ```bash # uvのインストール（まだの場合） curl -LsSf https://astral.sh/uv/install.sh | sh # プロジェクトディレクトリに移動 cd /path/to/CodeReviewResolvedMcp # 依存関係のインストール uv sync # 開発用依存関係も含める場合 uv sync --dev ``` ### 従来のpipを使用する方法 ```bash # プロジェクトディレクトリに移動 cd /path/to/CodeReviewResolvedMcp # インストール pip install -e . # 開発用の依存関係も含める場合 pip install -e ".[dev]" ``` ## MCPクライアントでの使用 ### Claude Desktopの設定 #### uvを使用する場合（推奨） `~/.config/Claude/claude_desktop_config.json` (Linux): ```json { "mcpServers": { "pr-review": { "command": "uv", "args": ["run", "pr-review-mcp"], "cwd": "/path/to/CodeReviewResolvedMcp" } } } ``` #### python3を使用する場合 ```json { "mcpServers": { "pr-review": { "command": "python3", "args": ["-m", "pr_review_mcp.server"], "cwd": "/path/to/CodeReviewResolvedMcp" } } } ``` ### 使用例 #### 1. レビュースレッド一覧の取得 ``` 未解決のレビューコメントを確認したいので、owner/repo の PR #123 のレビュースレッドを表示してください ``` #### 2. レビューコメントに返信 ``` thread_id: PRRT_xxx のスレッドに "修正しました。ご確認ください。" と返信してください ``` #### 3. レビュースレッドの解決 ``` thread_id: PRRT_xxx のスレッドを解決済みにしてください ``` #### 4. 返信と解決を一度に実行 ``` thread_id: PRRT_xxx のスレッドに "対応完了しました" と返信し、解決してください ``` ## ツールの詳細 ### list_review_threads PRのレビュースレッド一覧を取得します。 **パラメータ:** - `owner` (string, 必須): リポジトリオーナー - `repo` (string, 必須): リポジトリ名 - `pull_number` (integer, 必須): PR番号 - `unresolved_only` (boolean, オプション): 未解決のみ取得 (デフォルト: true) **出力例:** ```json { "pull_request": "owner/repo#123", "thread_count": 2, "threads": [ { "id": "PRRT_kwDOABC...", "is_resolved": false, "file": "src/main.py", "line": 42, "first_comment": { "author": "reviewer", "body": "このロジックを改善できますか？", "created_at": "2025-12-10T12:00:00Z" } } ] } ``` ### reply_to_review_thread レビュースレッドに返信を追加します。 **パラメータ:** - `owner` (string, 必須): リポジトリオーナー - `repo` (string, 必須): リポジトリ名 - `pull_number` (integer, 必須): PR番号 - `thread_id` (string, 必須): スレッドID - `body` (string, 必須): 返信内容（Markdownサポート） ### resolve_review_thread レビュースレッドを解決済みとしてマークします。 **パラメータ:** - `thread_id` (string, 必須): スレッドID ### reply_and_resolve レビュースレッドに返信し、即座に解決します。 **パラメータ:** - `owner` (string, 必須): リポジトリオーナー - `repo` (string, 必須): リポジトリ名 - `pull_number` (integer, 必須): PR番号 - `thread_id` (string, 必須): スレッドID - `body` (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が正しくインストール・認証されているか確認してください： ```bash gh auth status ``` 認証されていない場合： ```bash gh auth login ``` ### `Pull request not found` エラー - リポジトリ名、オーナー、PR番号が正しいか確認 - PRが実際に存在するか確認 - ghコマンドで該当リポジトリにアクセス権限があるか確認 ### `GraphQL errors` エラー - thread_idが正しいか確認（`list_review_threads`で取得したIDを使用） - PR番号が正しいか確認 - リポジトリへの書き込み権限があるか確認 ## ライセンス このプロジェクトはMITライセンスの下で公開されています。 ## 開発 ### 依存関係の管理 ```bash # 依存関係の追加 uv add <package-name> # 開発用依存関係の追加 uv add --dev <package-name> # 依存関係の同期 uv sync ``` ### コード品質チェック ```bash # Ruffでリント uv run ruff check . # Ruffでフォーマット uv run ruff format . # 型チェック（追加予定） # uv run mypy src/ ``` ### テストの実行 ```bash # すべてのテストを実行 uv run pytest # 詳細表示で実行 uv run pytest -v # 特定のテストファイルを実行 uv run pytest tests/test_gh_api.py # カバレッジ付きで実行（pytest-covが必要） # uv add --dev pytest-cov # uv run pytest --cov=pr_review_mcp ``` ## 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での自動テスト ```yaml # 実行タイミング - main ブランチへのプッシュ - develop ブランチへのプッシュ - main/develop ブランチへのプルリクエスト ``` #### Release（`.github/workflows/release.yml`） バージョンタグがプッシュされた時に自動実行されます： ```bash # リリース方法 git tag v0.1.0 git push origin v0.1.0 ``` このワークフローは： 1. パッケージをビルド 2. GitHub Releaseを作成 3. （オプション）PyPIに公開 #### Dependabot（`.github/dependabot.yml`） 依存関係の自動更新： - GitHub Actionsの更新（週次） - Python依存関係の更新（週次） ### ローカルでCI/CDと同じチェックを実行 ```bash # リント uv run ruff check . # フォーマットチェック uv run ruff format --check . # テスト uv run pytest -v ```