mcp-gh-pr-mini

mcp-gh-pr-mini

A minimal MCP (Model Context Protocol) server for interacting with GitHub pull requests.

This tool allows you to create, list, view diffs, request reviewers, and comment on pull requests in GitHub repositories via MCP.

✨ Features

• Create a pull request in a GitHub repository
• List open pull requests
• Get the diff for a pull request
• Request reviewers for a pull request
• Add a comment to a pull request
  • Comments are automatically prefixed with "[AI] Generated using MCP" for clear identification
  • Supports both general PR comments and position-specific code review comments
• Get comments from a pull request
• Get file changes with comment positions
  • Retrieves detailed information about changed files
  • Provides positions for adding review comments
  • Shows additions, deletions, and patch information for each file

🛠️ Setup

This tool runs as an MCP server in your local environment. You can use it with tools like Copilot Agent or any MCP-compatible client.

Requirements

• Node.js installed
• VSCode with an MCP-compatible extension (e.g., Copilot Agent)

Configure in settings.json

In your VSCode settings.json, add the following:

"mcp": {
  "servers": {
    "mcp-gh-pr-mini": {
      "command": "npx",
      "args": ["mcp-gh-pr-mini"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "{Your Fine-Grained GitHub Token}"
      }
    }
  }
}

🔐 Token Permissions

💡 Use a fine-grained GitHub personal access token with the following permissions:

• Pull requests: Read and write
• Issues: Read and write
• Contents: Read and write

🤔 Why?

This project provides a minimal, focused implementation for essential pull request tasks via MCP. It's designed to be simple and easy to understand, making it a good reference for building MCP servers.

🙏 Note

I'm still new to building MCP servers, so there may be areas that can be improved. Feedback, suggestions, and contributions are always welcome!