GitHub PR Analysis MCP Server
This project implements a Model Context Protocol (MCP) server that analyzes GitHub Pull Requests and optionally creates a structured Notion page with the analysis results. It is designed to be used locally with Claude CLI using the stdio MCP transport.
🚀 Features: Analyze GitHub Pull Requests using GitHub API Extract PR metadata, commits, files, and code changes Generate structured AI-based PR analysis Optionally create a Notion page with the analysis Runs locally via MCP stdio Integrates seamlessly with Claude CLI
🧠 Architecture Overview: Claude CLI │ │ (MCP stdio) ▼ MCP Server (Python) ├── GitHub API (PR data) ├── AI Analysis Logic └── Notion API (Page creation)
📁 Project Structure: MCP-STDIO/ ├── pr_analyzer.py # MCP server entry point ├── github_integration.py # GitHub PR fetching logic ├── requirements.txt # Python dependencies └── .venv/ # Virtual environment
🔑 Required Environment Variables:
The application relies on the following environment variables:
Variable Description GITHUB_TOKEN GitHub Personal Access Token NOTION_API_KEY Notion integration secret NOTION_PAGE_ID Parent Notion page ID
🔐 How to Create GITHUB_TOKEN: Go to 👉 https://github.com/settings/tokens
Click Generate new token (classic) Select scopes: ✅ repo ✅ read:user Generate token and copy it
🧾 How to Create NOTION_API_KEY: Go to 👉 https://www.notion.so/my-integrations
Click New integration Name it (e.g. PR Analyzer) Select your workspace Copy the Internal Integration Secret
📄 How to Create NOTION_PAGE_ID: Create a page in Notion (this will be the parent page) Share the page with your integration: Click Share Invite your integration Copy the page URL:
https://www.notion.so/AI-PR_ANALYSIS-2*************************
Extract the page ID (last 32 characters): 2***********************
📦 Dependencies (requirements.txt): Package Purpose requests Communicates with GitHub & Notion REST APIs python-dotenv Loads environment variables from .env fastmcp MCP server framework
🛠 Setup Instructions: 1️⃣ Create Virtual Environment cd MCP-STDIO python -m venv .venv source .venv/bin/activate
2️⃣ Install Dependencies pip install -r requirements.txt
3️⃣ Verify Server Runs Manually .venv/bin/python pr_analyzer.py
✅ This should start the MCP server without errors.
🤖 Using the MCP Server with Claude CLI 1️⃣ Ensure Claude CLI is Installed claude --version
Expected output:
2.x.x (Claude Code)
2️⃣ Configure MCP Server (~/.claude.json) { "mcpServers": { "github_pr_analysis": { "type": "stdio", "command": "full path of your .venv/bin/python ", "args": ["pr_analyzer.py"], "cwd": "full path of your pr_analyzer.py" } } }
⚠️ Make sure: command points to the virtualenv python cwd is the folder containing pr_analyzer.py
3️⃣ Restart Claude CLI claude 4️⃣ Verify MCP Server is Connected Inside Claude CLI: /mcp You should see: github_pr_analysis · ✔ connected 🧪 Example Usage in Claude Analyze this PR: https://github.com/org/repo/pull/123
Claude will: Fetch PR details Perform analysis
Ask: “Would you like me to create a Notion page for this analysis?”
Reply with: yes → creates Notion page no → skips creation
🐞 Debugging Tips Add logs in MCP server: print("Debug message", file=sys.stderr)
Check Claude MCP logs: claude --debug
Verify paths: pwd ls pr_analyzer.py
✅ Summary MCP server runs locally via stdio Claude CLI acts as the client GitHub PRs are analyzed automatically Notion pages are created on user confirmation Secure via environment variables
children=[{ "object": "block", "type": "paragraph", "paragraph": { "rich_text": [{ "type": "text", "text": {"content": content} }] } }]