GitHub PR & Issue Analyser

Analise pull requests do GitHub e gerencie issues, tags e releases.

Documentação

MCP para GitHub PR, Issues, Tags e Releases

CI Tag and Release Maintainability Codacy Badge

Um servidor MCP que conecta um LLM aos recursos de gerenciamento de repositórios do GitHub. Ele analisa pull requests, gerencia issues e lida com tags e releases, via stdio ou HTTP, com um token estático ou GitHub OAuth2.

  • Pull requests - busca diffs, conteúdo, issues vinculadas e status de CI, cria, comenta, revisa, mescla e atualiza, fecha, redireciona, rotula e alterna o status de rascunho, lê e corrige comentários publicados
  • Issues - cria, atualiza, lista, pesquisa e atribui, lê os rótulos de um repositório, executa marcos e registra issues neles
  • Releases - cria tags em commits, publica releases e lista, corrige ou retira o que foi publicado
  • Usuários - consulta de perfil, atividade de contribuição e crescimento de estrelas via GraphQL
  • Repositórios - lista o que um usuário, uma organização ou o chamador possui, e lê qualquer arquivo ou árvore de diretórios em um branch, tag ou SHA

A lista completa de ferramentas está em docs/tools.md.

Início rápido

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

Em seguida, adicione-o ao seu cliente:

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

Para o modo HTTP, Docker, Kubernetes e OAuth2, consulte a documentação abaixo.

Documentação

As páginas abaixo também são publicadas no Read the Docs.

PáginaConteúdo
InstalaçãoRequisitos, execução a partir do código-fonte, Docker, Kubernetes
ConfiguraçãoModos de autenticação, variáveis de ambiente, configuração do OAuth App, armazenamentos de token
Configuração do clienteConfigurações prontas para colar para token e OAuth2, por cliente
FerramentasCada ferramenta que o servidor registra e as habilidades que as acionam
ArquiteturaCaminho da solicitação do cliente até a API do GitHub
MétricasEndpoint Prometheus, nomes de métricas, configuração de coleta

Requisitos

Python 3.14 e um token de acesso pessoal do GitHub com os escopos repo e workflow ou um OAuth App do GitHub.

Código-fonte

Nosso código-fonte mais recente e atualizado de mcp-github-pr-issue-analyser pode ser encontrado no GitHub. Faça um fork!

Contribuindo

Adoraríamos :heart: que você contribuísse fazendo um pull request.

Leia o Guia de Contribuição oficial para obter mais informações sobre como você pode contribuir.