Code Review MCP Tool for Cursor

コードレビュー MCP ツール

このツールは、MCP 統合に対応したあらゆるアプリ向けに、自動コードレビューを行い、GitHub の PR にコメントを残す Model Context Protocol（MCP）サーバーです。

特徴

• 2 つの Git ブランチ間のコード差分を比較します
• GitHub のプルリクエスト URL からコード差分を比較します
• GitHub のプルリクエストに要約コメントを追加します
• GitHub のプルリクエストに行単位のコメントを追加します
• 詳細なコードレビューガイドラインを提供します
• Notion のコードブロックからレビューガイドラインを取得する Notion 統合に対応しており、取得できない場合は既定のガイドラインを使用します
• レビュー手順一式を記述したローカルの Markdown ファイルに対応しています
• あらかじめ設定されたスタイルガイドラインとコードレビューガイドラインを含みます
• ローカルディレクトリから PR テンプレートを読み込みます
• リポジトリ情報を自動検出して GitHub のプルリクエストを作成します
• レビュー手順を含まない、生の Git 差分出力を取得します

ツール

• CodeReview：ブランチとベースブランチ間で git diff を実行します。問題のレビューと修正に関する手順とともに、差分を返します。
• GetLocalGitDiff：ローカルで 2 つのブランチ間の git diff を取得します。レビュー手順を含まない、生の差分出力を返します。
• CodeReviewWithGithubUrl：GitHub の PR URL から差分を取得します。問題のレビューと修正に関する手順とともに、差分を返します。
• AddPRSummaryComment：GitHub の PR に要約コメントを追加します。
• AddPRLineComment：GitHub の PR の指定した行に複数のコメントを追加します。PR の差分内で変更された特定の行へのコメントに対応しています。
• GetPRTemplate：指定されたフォルダーパスとテンプレート名から PR テンプレートを読み込みます。テンプレートの内容を返し、見つからない場合は既定のテンプレートを返します。
• CreatePR：指定されたタイトル、本文、ブランチを使用して、新しい GitHub のプルリクエストを作成します。ローカルの Git 設定から GitHub URL と現在のブランチを自動検出します。

アーキテクチャ

• MCP サーバー：MCP 互換のクライアントアプリからコードレビューのリクエストを受け付けます。
• Git 統合：ローカルの Git または GitHub の PR を使って差分を生成します。
• Notion 統合：設定されている場合、Notion のコードブロックからレビューガイドラインを取得します。
• ローカルファイル対応：ローカルの Markdown ファイルからレビュー手順一式を読み込みます。
• 自動レビュー：コード差分を分析し、レビューコメントと提案を生成します。

前提条件

• Node.js（v18 以降を推奨）
• システムに Git がインストールされていること
• GitHub の PR をレビューするには、次のいずれかを用意する必要があります。
  • （GitHub RESTful API を使用するための）GITHUB_TOKEN 環境変数、または
  • GitHub CLI（gh）がインストールされ、認証済みであること
• （任意）ガイドライン統合用の Notion API トークン

MCP の設定

MCP に対応したアプリでこのツールを使用するには、次の手順に従います。

1. MCP 対応アプリの設定ファイルを開きます。
2. 次の設定を追加します。

{
  "mcpServers": {
    "code-review-tool": {
      "command": "npx",
      "args": ["-y", "code-review-mcp-server"],
      "env": {
        "GITHUB_TOKEN": "github_token",
        "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_code_block_url_here",
        "LOCAL_INSTRUCTIONS_FILE_PATH": "/path/to/complete-instructions.md",
        "IGNORE_PATTERNS": "pattern1,pattern2,pattern3"
      }
    }
  }
}

環境変数の説明

変数	必須	説明
GITHUB_TOKEN	任意	API アクセス用の GitHub 個人アクセストークンです。指定されていない場合は、GitHub CLI にフォールバックします。
LOCAL_INSTRUCTIONS_FILE_PATH	任意	レビュー手順をすべて含むローカルの Markdown ファイルへのパスです。指定すると、このファイルが Notion とデフォルトのガイドラインを組み合わせたものを完全に置き換えます。優先順位：ローカル > Notion > デフォルト。
IGNORE_PATTERNS	任意	レビュー対象から除外するファイルの、カンマ区切りの glob パターンです。
Notion
NOTION_API_KEY	任意	Notion からレビューガイドラインを取得する場合に必要です。
NOTION_CODE_REVIEW_GUIDELINE_CODE_BLOCK_URL	任意	コードレビューガイドラインを含む Notion URL です。Notion の </> Code ブロックを指定する必要があり、動作には有効な NOTION_API_KEY が必要です。設定されていない場合は、デフォルトのガイドラインにフォールバックします。
NOTION_STYLE_GUIDELINE_CODE_BLOCK_URL	任意	スタイルガイドラインを含む Notion URL です。Notion の </> Code ブロックを指定する必要があり、動作には有効な NOTION_API_KEY が必要です。設定されていない場合は、デフォルトのガイドラインにフォールバックします。

レビュー手順の優先順位

このツールは、次の優先順位で複数のレビュー手順ソースに対応しています（実装）。

1. ローカルの Markdown ファイル（最優先）

   • LOCAL_INSTRUCTIONS_FILE_PATH 環境変数で設定します
   • .md または .markdown ファイルである必要があります
   • 利用可能な場合、ほかのすべての手順ソースを完全に置き換えます
   • ファイルを読み込めない場合は、Notion／デフォルトにフォールバックします

2. Notion 連携（中優先）

   • Notion のスタイルガイドラインとコードレビューガイドラインを組み合わせます
   • NOTION_API_KEY と、対応する URL の環境変数が必要です

3. デフォルトのガイドライン（最優先度が低い）

   • 組み込みのスタイルガイドとコードレビューガイドラインです
   • 常にフォールバックとして利用できます

Notion 連携の設定

1. Notion API トークンをリクエストする

1. Notion Developers にアクセスします
2. 新しい Integration を作成します
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

これらは、上記のように MCP 設定の env セクションで指定できます。

3. Notion ページに Integration を追加する

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

注：現在は Notion のコードブロックの読み取りにのみ対応しています

詳細な手順については、Notion API 接続ガイドを参照してください。

使用方法

ヒント：レビュー結果をより良くするには、コードレビューコマンドを実行する前に、レビュー対象のブランチに切り替えることをおすすめします。

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

MCP 対応アプリで、次のコマンドを送信します。

code review
base branch: branch/any_branch

次の処理が行われます。

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

生の Git Diff を取得する

レビュー手順なしで git diff のみを取得するには、次のコマンドを実行します。

get local git diff
base branch: main

現在のブランチと指定したベースブランチの間の生の git diff 出力が返されます。追加の処理や分析に利用できます。

GitHub PR のレビュー

MCP 対応アプリで、次のコマンドを送信します。

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

After generating the review report, please:

1.  Add PR summary comment
2.  If individual files require suggested changes, use line comments.

これにより、PR の差分を取得してコードレビューを行い、GitHub 上に直接 PR コメントを残します。

GitHub プルリクエストの作成

リポジトリを自動検出して PR を作成します。

create PR base on diff
base branch: main

このツールは次の処理を行います。

• git remote から GitHub リポジトリの URL を自動検出します
• 現在のブランチをソースブランチとして使用します
• 現在のブランチがリモートにプッシュ済みであることを確認します
• GitHub CLI または REST API を使用して PR を作成します
• ドラフト PR の作成とマイルストーンの割り当てに対応します

手動での上書き（自動検出に失敗した場合）：

create PR
github url: https://github.com/user/repo
base branch: main

PR テンプレートの読み取り

リポジトリから PR テンプレートを読み取ります。

get PR template

これにより、次の処理が行われます。

• 指定したフォルダー内で pull_request_template.md を検索します
• .github/ サブディレクトリも確認します
• テンプレートの内容を返します。見つからない場合はデフォルトのテンプレートを返します

カスタムテンプレート名：

get PR template
folder path: /path/to/your/repo/template
template name: custom_template.md

自動コードレビューのための CI 統合

n8n の Webhook をトリガーすることで、CI パイプラインでコードレビューを自動化できます。Webhook はこのプロジェクトの MCP ツールを呼び出してレビューを行い、結果を返すか、PR にコメントを残します。

手順ごとのガイドと推奨ワークフロー図については、n8n と MCP ツールによる CI 統合を参照してください。

レビューガイドライン

このツールでは、レビューガイドラインを複数の方法で設定できます。

1. ローカルの Markdown 指示ファイル（推奨）

Markdown 形式の指示ファイルを作成し、LOCAL_INSTRUCTIONS_FILE_PATH 環境変数を設定します。これにより、レビューのプロセスに最も柔軟性を持たせ、バージョン管理できます。

2. Notion との連携

Notion のコードブロックを使用して、スタイルとコードレビューのガイドラインを個別に設定します。

3. デフォルトのガイドライン

このツールには、次の内容を網羅する組み込みのガイドラインが含まれています。

• スタイルガイド：変数名、関数名、定数名などに関するコードスタイル基準です。
• コードレビューガイドライン：SOLID 原則、可読性、不変性などに基づくコード品質基準です。