MCP for GitHub PR, Issues, Tags and Releases
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, label 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.