mcp-gh-pr-mini

by y-hirakaw

158 downloads
Not rated
GitHub

About

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

Details

Author
y-hirakaw
Downloads
158
Categories
Developer Tools

- 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 comments (prefixes with "[AI] Generated using MCP")
- Get comments and file changes with comment positions

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name mcp-gh-pr-mini
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Configure the server in your VSCode settings.json using the command npx mcp-gh-pr-mini and set the GITHUB_PERSONAL_ACCESS_TOKEN environment variable. You need Node.js and a VSCode extension that supports MCP (e.g., Copilot Agent). The server is invoked automatically by your MCP client when you use the provided tools.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp-gh-pr-mini": {
            "mcp-gh-pr-mini": {
                "command": "npx",
                "args": [
                    "mcp-gh-pr-mini"
                ],
                "env": {
                    "GITHUB_PERSONAL_ACCESS_TOKEN": ""
                }
            }
        }
    }
}

McpServers

{
    "mcp-gh-pr-mini": {
        "command": "npx",
        "args": [
            "mcp-gh-pr-mini"
        ],
        "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": ""
        }
    }
}

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!

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.