MCP Test

🚀 PR レビュアー設定ガイド

このガイドでは、PR レビュアープロジェクトの設定方法を段階的に説明します。GitHub と Notion との統合も含まれています。

🚀 クイックスタート

このガイドを通じて、PR レビュアープロジェクトの設定方法を学ぶことができます。GitHub と Notion との統合を含め、必要な手順を段階的に説明します。

✨ 主な機能

• GitHub と Notion との統合を通じた PR レビューの自動化
• 必要な依存関係の自動インストール

📦 インストール

前提条件

• curl（MacOS/Linux用）
• システムにPython 3.xがインストールされていること

設定手順

ステップ1：uv のインストール

MacOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

🔁 インストールが完了したら、ターミナルを再起動して uv コマンドが使用可能か確認してください。

ステップ2：プロジェクトの作成と設定

MacOS/Linux:

# プロジェクト用の新しいディレクトリを作成
uv init pr_reviewer
cd pr_reviewer

# 仮想環境の作成とアクティブ化
uv venv
source .venv/bin/activate

# 核心依存関係のインストール
uv add "mcp[cli]" requests python-dotenv notion-client

ステップ3：requirements.txt の作成とインストール

requirements.txt という名前のファイルを作成し、以下の内容を追加します。

# PR 分析器の核心依存関係
requests>=2.31.0          # GitHub API 呼び出し用
python-dotenv>=1.0.0      # 環境変数用
mcp[cli]>=1.4.0           # MCP サーバー機能用
notion-client>=2.3.0      # Notion 統合用

パッケージをインストールします。

uv pip install -r requirements.txt
pip install -r requirements.txt

ステップ4：環境変数の設定

ルートディレクトリに .env ファイルを作成し、以下の内容を追加します。

GITHUB_TOKEN=your_github_token
NOTION_API_KEY=your_notion_api_key
NOTION_PAGE_ID=your_notion_page_id

GitHubトークン：

1. GitHub → 設定 → 開発者設定 → 個人用アクセストークンに移動します。
2. “新しいトークン（クラシック）を生成” をクリックします。
3. 以下の範囲を有効にします。
   • read:org
   • read:repo_hook
   • repo
4. トークンを .env ファイルに GITHUB_TOKEN としてコピーします。

Notion 統合：

1. Notion 統合に移動します。
2. “新しい統合を作成” をクリックし、タイプを 内部 に設定します。
3. ワークスペースに追加します。
4. 内部統合キー を NOTION_API_KEY としてコピーします。
5. 統合URLの末尾のUUID を NOTION_PAGE_ID としてコピーします。

ステップ5：メインスクリプトの作成

サーバーロジック用の空のスクリプトファイルを作成します。

touch pr_reviewer

このファイルにアプリケーションロジックを追加します。

ステップ6：アプリケーションの実行

プロジェクトを実行するには、環境がアクティブ化され、.env が正しく設定されていることを確認してください。

python pr_reviewer.py