Code Review MCP Server

🚀 Cursor用MCPツールコードレビューツール

このツールは、モデルコンテキストプロトコル（MCP）に基づくCursorプラグインで、自動的にgit差分を生成し、コードレビューを実行することができます。

✨ 主な機能

• 2つのGitブランチ間のコード差分を比較する
• GitHubのプルリクエストURLからコード差分を比較する
• GitHubのプルリクエストに要約コメントを追加する
• GitHubのプルリクエストに特定行のコメントを追加する
• 詳細なコードレビューガイドを提供する
• Notionとの統合をサポートし、Notionのコードブロックからレビューガイドを取得し、デフォルトのガイドをバックアップとして使用する
• 事前に設定されたスタイルとコードレビューガイドを含む

📦 インストール

GitHub CLIのインストール

このツールは、GitHubコマンドラインインターフェイスがマシンにグローバルにインストールされていることを要求します。

# MacOS
brew install gh

# Windows
winget install -e --id GitHub.cli

# Linux
sudo apt install gh  # Debian/Ubuntu

インストールが完了したら、GitHubアカウントで認証を行います。

gh auth login

その他のインストールオプションについては、GitHub CLIドキュメントを参照してください。

Cursorの設定

このツールをCursorで使用するには、Cursor設定に以下の構成を追加します。

1. Cursor設定（通常は ~/.cursor/config.json）を開きます。
2. 以下の構成を追加します。

{
  "mcpServers": {
    "code-review-tool": {
      "command": "npx",
      "args": ["-y", "code-review-mcp-server"],
      "env": {
        "NOTION_API_KEY": "notion_api_key",
        "NOTION_CODE_REVIEW_GUIDELINE_CODE_BLOCK_URL": "notion_code_block_url_here",
        "NOTION_STYLE_GUIDELINE_CODE_BLOCK_URL": "notion_style_guideline_url_here"
      }
    }
  }
}

参考ドキュメント：Cursorモデルコンテキストプロトコル

Notion統合の設定

1. Notion APIトークンの取得

1. Notion開発者にアクセスします。
2. 新しい統合を作成します。
3. APIトークンを取得します。

詳細な説明は、Notion API認証ガイドを参照してください。

2. 環境変数の設定

ツールには以下の環境変数が必要です。

NOTION_API_KEY=your_token_here
NOTION_CODE_REVIEW_GUIDELINE_CODE_BLOCK_URL=your_notion_code_block_url
NOTION_STYLE_GUIDELINE_CODE_BLOCK_URL=your_notion_style_guideline_url

これらは、上記のCursor設定の env セクションで提供することができます。

3. Notionページへの統合の追加

1. ページの 共有 ボタンをクリックします。
2. 統合をページの共有リストに追加します。

注意：現在はNotionのコードブロックからの読み取りのみサポートされています。

詳細な説明は、Notion API接続ガイドを参照してください。

💻 使用例

ローカルGitブランチのレビュー

Cursorチャットウィンドウに以下のコマンドを入力します。

code review
baseブランチ: branch/any_branch

この操作により、以下のことが行われます。

1. 現在のブランチと指定されたベースブランチ間の差分を比較します。
2. git差分を自動生成します。
3. スタイルとコードレビューガイドに基づいてレビューを実行します。
4. 詳細なレビュー結果と改善提案を提供します。

GitHub PRのレビュー

Cursorチャットウィンドウに以下のコマンドを入力します。

code review
https://github.com/owner/repo/pull/123

レビューレポートを生成した後、以下の操作を行ってください。
1. PRの要約コメントを追加します。
2. 提供されたコード内で **行コメント** を使用して、特定の改善提案を提供します。

この操作により、PRの差分が取得され、コードレビューが行われます。

📚 ドキュメント

• 2つのGitブランチ間のコード差分を比較する
• GitHubのプルリクエストURLからコード差分を比較する
• GitHubのプルリクエストに要約コメントを追加する
• GitHubのプルリクエストに特定行のコメントを追加する
• 詳細なコードレビューガイドを提供する
• Notionとの統合をサポートし、Notionのコードブロックからレビューガイドを取得し、デフォルトのガイドをバックアップとして使用する
• 事前に設定されたスタイルとコードレビューガイドを含む