MCP for GitHub PR, Issues, Tags and Releases

Tag and Release Maintainability Codacy Badge

An MCP server that connects an LLM to GitHub's repository management features. It analyses pull requests, manages issues, and handles tags and releases, over stdio or HTTP, with a static token or GitHub OAuth2.

Pull requests - fetch diffs, content, linked issues and CI status, create, comment, review, merge and update, close, retarget and flip draft status, read and correct posted comments
Issues - create, update, list, search and assign, read a repository's labels, run milestones and file issues under them
Releases - tag commits, publish releases, and list, correct or withdraw what is published
Users - profile lookup, contribution activity and star growth via GraphQL
Repositories - list what a user, an organisation or the caller owns, without knowing the names

The full tool list is in docs/tools.md.

Quick start

export GITHUB_TOKEN="<github-token>"
uvx https://github.com/saidsef/mcp-github-pr-issue-analyser.git

Then add it to your client:

{
  "mcpServers": {
    "github_prs_issues": {
      "command": "uvx",
      "args": [
        "https://github.com/saidsef/mcp-github-pr-issue-analyser.git"
      ],
      "env": {
        "GITHUB_TOKEN": "<your-github-token>"
      }
    }
  }
}

For HTTP mode, Docker, Kubernetes and OAuth2, see the documentation below.

Documentation

The pages below are also published on Read the Docs.

Page	Contents
Installation	Requirements, running from source, Docker, Kubernetes
Configuration	Auth modes, environment variables, OAuth App setup, token stores
Client configuration	Ready-to-paste configs for token and OAuth2, per client
Tools	Every tool the server registers, and the skills that drive them
Architecture	Request path from client to GitHub API
Metrics	Prometheus endpoint, metric names, scrape setup

Requirements

Python 3.12+, and a GitHub personal access token with repo scope or a GitHub OAuth App.

Source

Our latest and greatest source of mcp-github-pr-issue-analyser can be found on GitHub. Fork us!

Contributing

We would :heart: you to contribute by making a pull request.

Please read the official Contribution Guide for more information on how you can contribute.

GitHub PR Issue Analyser