PR Reviewer
- other
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.
About
What is PR Reviewer?
PR Reviewer is a tool that analyzes GitHub pull requests and creates detailed reports in Notion, using the Model Context Protocol (MCP) to integrate these services. It is intended for developers who need automated, structured PR analysis and documentation.
How to use PR Reviewer?
After installing Python 3.13+, the MCP CLI, and obtaining GitHub and Notion API credentials, set up a virtual environment, install dependencies, and create a .env file with your tokens. Run the MCP server with python pr_anayzer.py, then interact with it via an MCP Host such as Claude AI to request PR analysis and create Notion pages.
Key features of PR Reviewer
- Fetches changes from GitHub pull requests
- Creates detailed reports in Notion
- Uses MCP server for PR analysis requests
- Requires Python 3.13 or higher
- Supports integration with MCP Hosts like Claude AI
Use cases of PR Reviewer
- Automated PR review summaries synced to Notion
- Centralized documentation of code changes in team Notion databases
- Quick analysis of multiple pull requests via an AI assistant
FAQ from PR Reviewer
What does PR Reviewer do?
It retrieves changes from a GitHub pull request and generates a structured report, then creates a Notion page with that analysis.
Which platforms or AI models can host the MCP server?
The README explicitly mentions using Claude AI as the MCP Host to interact with the PR Reviewer MCP server.
Does PR Reviewer require an MCP server?
Yes, it runs an MCP server (pr_anayzer.py) that must be started before requests can be processed. The server communicates with an MCP Host.
Is PR Reviewer free to use?
The project is licensed under the MIT License, so it is free to use and modify. You only need your own GitHub and Notion API keys.
Are there any known limitations?
The README does not mention any limits. You should ensure you have valid GitHub and Notion credentials and that your environment meets the Python 3.13+ requirement.
Details
- Author
- attikpo-akrabal-godwin
- GitHub stars
- 2
- Category
- other
- Repository
- attikpo-akrabal-godwin/pr-reviewer
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 tokenInstallation
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.
