Code Review MCP

🚀 Code Review MCP — Cursor-first PR reviewer

このエンドツーエンドのMCPは、ローカルのツールチェーンとCursorのAIを使用してGitHubのPRをレビューします。PRの差分を取得し、プロジェクトのドキュメントを読み込み、静的解析・セキュリティチェック・テストを実行し、許可された場合にインラインコメントを投稿し、Markdownレポートを生成します。

🚀 クイックスタート

このMCPを使用することで、GitHubのPRを自動的にレビューし、レポートを生成できます。以下のセクションでは、必要な要件、インストール方法、使用方法などを説明します。

✨ 主な機能

• GitHubのPR差分を取得し、プロジェクトドキュメントを読み込みます。
• 静的解析、セキュリティチェック、テストを実行します。
• 許可された場合、インラインコメントを投稿します。
• Markdownレポートを生成します。

📦 インストール

必要な要件

• Node.js 18+
• Cursor
• GitHub Personal Access Token (repo permissions) — .env.mcp を介して読み込まれます
• オプションのツール (自動検出; 存在しない場合はスキップ):
  • プロジェクトのdevDependenciesに含まれるESLint、Prettier、TypeScript (tsc)
  • Semgrep CLI (pipx install semgrep または brew install semgrep)
  • Playwright (npm i -D @playwright/test および npx playwright install)

インストール手順

1. このリポジトリをクローンするか (tools/mcp-code-review.mjs と .mcp/code-review/ をプロジェクトリポジトリにコピーします)
2. リポジトリ内でNodeの依存関係をインストールします: npm ci (または npm i)
3. .cursor/mcp.json が tools/mcp-code-review.mjs の絶対パスを指していることを確認します。

例としての .cursor/mcp.json:

{
  "mcpServers": {
    "code-review": {
      "command": "node",
      "args": ["/absolute/path/to/tools/mcp-code-review.mjs"]
    }
  }
}

🔧 環境設定 (認証)

• MCPはデフォルトで .env.mcp (リポジトリルート) を読み込みます。または --env-file=/path/to/env を指定できます。
• 必須項目:
  • GITHUB_TOKEN=... (対象のリポジトリにアクセスできる必要があります; 組織がSSOを強制している場合はSSO認証が必要です)
• オプション項目:
  • JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_KEY
  • FIGMA_TOKEN
  • SEMGREP_RULES_DIR=.mcp/code-review/semgrep-rules

💻 使用例

基本的な使用法

ターゲットリポジトリ内のCursorチャットで以下のコマンドを実行します:

• @code-review 123 (gitのオリジンからリポジトリを自動検出)
• @code-review owner/repo#123
• @code-review https://github.com/owner/repo/pull/123
• @code-review latest

高度な使用法

フラグ

• --env-file=/abs/path/to/.env.mcp (デフォルトを上書き)
• --dry-run (コメント投稿をスキップし、レポートを生成するだけ)
• --commit-report (許可された場合、レポートをPRブランチにコミット)
• --auto-fix または --auto-fix=force (ESLint/Prettierの修正を適用し、コミットしてプッシュ)
• --skip-static --skip-security --skip-tests --skip-figma
• --semgrep-rules-dir=/path/to/rules (ルールを上書き)
• --max-diff-chars=20000 --max-file-hunks=10 --verbose

出力

• ログ: mcp-logs/ (実行ごとのファイル)
• アーティファクト: mcp-artifacts/<owner>-<repo>-PR<#>-<ts>/
• レポート: mcp-reports/code-review-<owner>-<repo>-PR<#>-<ts>.md

注意事項

• 認証されたユーザーがPRの作成者である場合、GitHubはレビューの投稿を拒否することがあります。MCPはコメントをスキップしますが、レポートは引き続き作成します (レポート内のパイプラインステータスを参照)。
• 古いログ/レポート (1日以上前のもの) は削除され、PRの最新のレポートのみが保持されます。

🚧 サブツール (高度な使用)

特定のツールを直接呼び出すことができます:

• @github.resolve_pr { prId: "owner/repo#123" }
• @github.fetch_files { owner: "owner", repo: "repo", pull_number: 123 }
• @jira.fetch { prMeta: { title: "...", body: "...", branch: "..." } }
• @analysis.run_static { files: ["src/..."], runTsc: true }
• @security.run_semgrep {}
• @tests.run_playwright {}
• @report.generate {...}
• @cleanup.prune { owner:"owner", repo:"repo", pull_number:123 }

📈 CI推奨事項

一貫したエンフォースメントのために、CIで同じツールを実行します:

• ESLint: npx eslint . --max-warnings=0
• Prettier: npx prettier --check .
• Semgrep: pipx install semgrep && semgrep --config .mcp/code-review/semgrep-rules --error -- .
• Playwright: npx playwright install --with-deps && npx playwright test --reporter=line

🛠️ トラブルシューティング

• 認証情報が不正な場合: .env.mcp が存在し、ログに Auth loaded from .env.mcp:... が表示されていることを確認します。PATを検証します: curl -H "Authorization: Bearer $GITHUB_TOKEN" https://api.github.com/user → 200である必要があります。
• Jiraがスキップされる場合: PRブランチ/タイトル/本文にJiraキーが含まれていること、および JIRA_* が設定されていることを確認します。
• Semgrepがスキップされる場合: CLIをインストールするか、ルールディレクトリを設定します。
• Playwrightがスキップされる場合: playwright.config.* を追加し、ブラウザをインストールします。

，特定プラットフォーム (macOS/Windows) のセットアップについては、docs/Platform-Setup.md を参照してください。