PR Reviewer

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Manages environment variables for configuring GitHub and Notion API authentication and other sensitive settings.

  • Enables automated review of Pull Requests through the GitHub API, with capabilities to analyze code changes and provide feedback.

  • Integrates with Notion's workspace to store, organize, and track PR review data using Notion's database capabilities.

PR Reviewer Setup Guide

This guide provides step-by-step instructions to set up the PR Reviewer project, which includes integrations with GitHub and Notion.

Prerequisites

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

Setup Instructions

Step 1: Install uv

MacOS/Linux:

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

🔁 Restart your terminal afterwards to ensure that 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 called requirements.txt with the following content:

# Core dependencies for 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:

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 these scopes:
    • read:org
    • read:repo_hook
    • repo
  4. Copy and paste the token into your .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 your server logic:

touch pr_reviewer

Add your application logic inside this file.


Step 6: Run the Application

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

python pr_reviewer.py

-
security - not tested
F
license - not found
-
quality - not tested

A tool that integrates with GitHub and Notion to analyze and review pull requests, enabling automated code reviews and documentation in Notion.

  1. Prerequisites
    1. Setup Instructions
      1. Step 1: Install uv
      2. Step 2: Create and Set Up the Project
      3. Step 3: Create requirements.txt and Install from It
      4. Step 4: Set Up Environment Variables
      5. Step 5: Create the Main Script
      6. Step 6: Run the Application
    ID: hdyjdwqhhl