MCP Test

🚀 PR Reviewer Setup Guide

This guide provides step-by-step instructions for setting up the PR reviewer project, including integration with GitHub and Notion.

🚀 Quick Start

✨ Features

• Step-by-step guide for setting up the PR reviewer project.
• Integration with GitHub and Notion.

📦 Installation

Prerequisites

• curl (for MacOS/Linux)
• Python 3.x installed on the system

Step 1: Install uv

MacOS/Linux:

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

⚠️ Important Note

After installation, please restart your terminal to ensure the uv command is available.

Step 2: Create and Set Up the Project

MacOS/Linux:

# Create a new directory for the project
uv init pr_reviewer
cd pr_reviewer

# Create and activate a virtual environment
uv venv
source .venv/bin/activate

# Install core dependencies
uv add "mcp[cli]" requests python-dotenv notion-client

Step 3: Create requirements.txt and Install from It

Create a file named requirements.txt and add the following content:

# Core dependencies for the PR analyzer
requests>=2.31.0          # For GitHub API calls
python-dotenv>=1.0.0      # For environment variables
mcp[cli]>=1.4.0           # For MCP server functionality
notion-client>=2.3.0      # For Notion integration

Install the packages:

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

Step 4: Set Up Environment Variables

Create a .env file in the root directory and add the following content:

GITHUB_TOKEN=your_github_token
NOTION_API_KEY=your_notion_api_key
NOTION_PAGE_ID=your_notion_page_id

GitHub Token:

1. Go to GitHub → Settings → Developer settings → Personal access tokens.
2. Click “Generate new token (classic)”.
3. Enable the following scopes:
   • read:org
   • read:repo_hook
   • repo
4. Copy the token to the .env file as GITHUB_TOKEN.

Notion Integration:

1. Go to Notion Integrations.
2. Click “New integration” and set the type to Internal.
3. Add it to your workspace.
4. Copy the Internal integration secret as NOTION_API_KEY.
5. Copy the UUID at the end of the integration URL as NOTION_PAGE_ID.

Step 5: Create the Main Script

Create an empty script file for the server logic:

touch pr_reviewer

Add your application logic to this file.

Step 6: Run the Application

To run the project, make sure the environment is activated and .env is configured:

python pr_reviewer.py