What is Pr Reviewer

PR-Reviewer is a tool designed to analyze GitHub pull requests and generate detailed reports in Notion. It utilizes the MCP (Model Context Protocol) to enhance communication and integration between various services.

Use cases

Use cases for PR-Reviewer include generating reports for code reviews, tracking changes in pull requests, and facilitating team discussions around code modifications in Notion.

How to use

To use PR-Reviewer, clone the repository, set up a virtual environment, install dependencies, configure your GitHub and Notion credentials in a .env file, and run the MCP server using the command ‘python pr_analyzer.py’. You can then interact with the MCP Host to create Notion pages with PR analyses.

Key features

Key features of PR-Reviewer include fetching changes from GitHub pull requests, generating detailed reports in Notion, and operating an MCP server for handling PR analysis requests.

Where to use

PR-Reviewer is primarily used in software development environments where GitHub is utilized for version control and collaboration, particularly in teams that use Notion for documentation and reporting.

PR Reviewer

Description

PR Reviewer is a tool designed to analyze GitHub pull requests and create detailed reports in Notion. It leverages the MCP (Model Context Protocol) to facilitate communication and integration between different services.

PRE REQUISITES

• MCP https://blog.stackademic.com/model-context-protocol-mcp-in-ai-9858b5ecd9
• Source tuto https://www.datacamp.com/tutorial/mcp-model-context-protocol

Features

• Fetch changes from GitHub pull requests.
• Create detailed reports in Notion.
• MCP server for handling PR analysis requests.

Requirements

• Python 3.13 or higher
• MCP CLI
• Notion API key
• GitHub API token

Installation

1. Clone the repository:

   git clone https://github.com/attikpo-akrabal-godwin/PR-Reviewer.git
   cd pr-reviewer
   

2. Create a virtual environment and activate it:

   python -m venv .venv
   source .venv/bin/activate  # On Windows use `.venv\Scripts\activate`
   

3. Install the dependencies:

   pip install -r requirements.txt
   

4. Create a .env file in the project root and add your GitHub and Notion credentials:

   GITHUB_TOKEN=your_github_token
   NOTION_API_KEY=your_notion_api_key
   NOTION_PAGE_ID=your_notion_page_id
   NOTION_DATABASE_ID=your_notion_database_id
   

Usage

1. Run the MCP server:

   python pr_anayzer.py
   

2. Use the MCP Host (Claude ai) to interact with this MCP server . For example

3. from claude ai you can create a Notion page with the PR analysis:
   

Project Structure

• main.py: Entry point for the project.
• pr_anayzer.py: Contains the PRAnalyzer class which initializes the MCP server and registers tools for PR analysis.
• github_integration.py: Contains functions to fetch changes from GitHub pull requests.
• .env: Environment variables for GitHub and Notion credentials.
• requirements.txt: List of dependencies.
• pyproject.toml: Project metadata and dependencies.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contributing

Contributions are welcome! Please open an issue or submit a pull request for any improvements or bug fixes.

Contact

For any questions or inquiries, please contact [email protected].