🤖 PR Reviewer with Claude + Notion + GitHub
This project automates the analysis of Pull Requests (PRs) using a LLM (Claude) connected via the MCP (Model Context Protocol).
The system receives a PR link, generates a technical summary, and stores it in a Notion page as documentation.
🧩 Architecture
- The user sends a PR URL to Claude Desktop.
- Claude interprets the request and uses its internal MCP Client.
- The MCP Client sends a structured request to the local MCP Server.
- The MCP Server acts as an adapter to fetch PR data from GitHub and save a summary to Notion, using both platforms’ APIs.
- The retrieved and processed information is returned to Claude, who presents it to the user as a technical summary.
- Finally, the information is automatically saved to a Notion page.
✨ Features
- Automatically fetches PR changes via GitHub API.
- Uses Claude Desktop to generate a semantic analysis of the code.
- Creates a Notion entry with the generated summary.
- Modular and extensible: you can add more tools to the MCP server.
🚀 How It Works
- Claude Desktop detects the MCP server when it runs locally.
- The user sends a PR link to Claude.
- Claude calls the MCP server and uses:
fetch_pr→ fetches PR metadata and diffs from GitHub.create_notion_page→ saves the analysis in a new Notion page.
- The whole process is triggered from Claude's interface with no manual steps.
🔧 Requirements
- Python 3.10+
- Claude Desktop
- Account / API key from:
⚙️ Setup
-
Install
uv(lightweight Python environment manager):curl -LsSf https://astral.sh/uv/install.sh | sh
-
Initialize project:
uv init pr_reviewer cd pr_reviewer uv venv source .venv/bin/activate
-
Install dependencies:
uv add "mcp[cli]" requests python-dotenv notion-client
-
Create
.envfile:GITHUB_TOKEN=ghp_*************** NOTION_API_KEY=secret_************** NOTION_PAGE_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
-
Configure Claude Desktop with the
claude_desktop_config.jsonfile, e.g.:{ "mcpServers": { "pr-reviewer": { "command": "/path/to/python", "args": ["/path/to/pr_anayzer.py"], "cwd": "/path/to/project" } } }
🧪 Usage
-
Run the MCP server:
python pr_anayzer.py -
Open Claude Desktop and pass a PR link:
https://github.com/your_username/your_repo/pull/1 -
Claude will analyze the PR and ask whether to save the result in Notion.
📌 Possible Improvements
- Full automation using
n8nor GitHub Actions. - PR validation with custom rules.
- Integration with other tools like Slack or ClickUp.
Metadata
Release files for iflow-mcp_andy-aranda-pr-reviewer 0.1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_andy_aranda_pr_reviewer-0.1.3.tar.gz | 4.8 kB | Without provenance | Details for iflow_mcp_andy_aranda_pr_reviewer-0.1.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_andy_aranda_pr_reviewer-0.1.3-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_andy_aranda_pr_reviewer-0.1.3-py3-none-any.whl |
Total release size: 10.5 kB
Release files / iflow_mcp_andy_aranda_pr_reviewer-0.1.3.tar.gz
| Download URL | iflow_mcp_andy_aranda_pr_reviewer-0.1.3.tar.gz |
|---|---|
| Size | 4.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
630e04408fcc01da6d76235b49ca372ac5038ebe1700b26a80c388900bf70caf
|
|
BLAKE2b-256 checksum How to use checksums |
795783eb6a2866c5365f2a18b545831e93f950c1203dba5578a4bc46667a947d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_andy_aranda_pr_reviewer-0.1.3-py3-none-any.whl
| Download URL | iflow_mcp_andy_aranda_pr_reviewer-0.1.3-py3-none-any.whl |
|---|---|
| Size | 5.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8d98a3ba64e7147e62839e2907b56bc4faa2affb76ce26cd467851a9bf16a9da
|
|
BLAKE2b-256 checksum How to use checksums |
e828ace8e0505765377031a6503b1a3ac97b0997c1e2f65ddf876e5c4dc6e60f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_andy-aranda-pr-reviewer 0.1.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.