
PR Reviewer
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.
What is PR Reviewer?
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.
How to use PR Reviewer?
To use PR Reviewer, clone the repository, set up your environment with the required dependencies, and run the MCP server. You can then interact with the server to analyze pull requests and create reports in Notion.
Key features of PR Reviewer?
- Fetch changes from GitHub pull requests.
- Create detailed reports in Notion.
- MCP server for handling PR analysis requests.
Use cases of PR Reviewer?
- Analyzing code changes in pull requests.
- Generating reports for team reviews in Notion.
- Streamlining the pull request review process.
FAQ from PR Reviewer?
- What are the prerequisites for using PR Reviewer?
You need Python 3.13 or higher, MCP CLI, Notion API key, and GitHub API token.
- Is PR Reviewer free to use?
Yes! PR Reviewer is open-source and free to use.
- How do I contribute to PR Reviewer?
Contributions are welcome! Please open an issue or submit a pull request for any improvements or bug fixes.
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
-
Clone the repository:
git clone https://github.com/attikpo-akrabal-godwin/PR-Reviewer.git cd pr-reviewer
-
Create a virtual environment and activate it:
python -m venv .venv source .venv/bin/activate # On Windows use `.venv\Scripts\activate`
-
Install the dependencies:
pip install -r requirements.txt
-
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
-
Run the MCP server:
python pr_anayzer.py
-
Use the MCP Host (Claude ai) to interact with this MCP server . For example
- 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 thePRAnalyzer
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 attikpoakrabal@gmail.com.