GitHub MCP é o servidor oficial mantido pela GitHub que expõe as principais operações da plataforma a qualquer cliente MCP (Claude Desktop, Claude Code, Cursor, Windsurf). Permite a um agente listar e ler repositórios, abrir e comentar issues e pull requests, pesquisar código em múltiplos repositórios, e disparar GitHub Actions. A autenticação usa um Personal Access Token com o alcance que o utilizador decidir, o que limita o raio de ação do agente aos repositórios autorizados. Desbloqueia fluxos típicos como triagem de issues, revisão assistida e automação de releases sem passar pela web da GitHub.

Funcionalidades

  • Leitura, pesquisa e operação em issues e pull requests
  • Revisões de PR (criar, submeter, comentários, replies)
  • Merge, atualização, fork e edição de pull requests
  • Branches, commits, tags e releases (listar, criar, ler)
  • Leitura e escrita de ficheiros do repositório (incluindo árvore)
  • Pesquisa de código, repositórios, utilizadores e organizações
  • GitHub Actions: listar workflows, disparar runs, obter logs
  • Alertas Dependabot, code scanning e secret scanning
  • Security advisories globais e por repositório
  • Discussions, gists e GitHub Projects
  • Notificações (listar, dispensar, marcar lidas, gerir subscrições)
  • Atribuição de Copilot a issues e Copilot code review
  • Copilot Spaces e tarefas com Copilot coding agent
  • Pesquisa na documentação de suporte da GitHub

Ferramentas disponíveis

  • actions_get Obtém detalhes de recursos GitHub Actions (workflows, runs, jobs e artifacts).
  • actions_list Lista workflows GitHub Actions de um repositório.
  • actions_run_trigger Dispara ações de workflows GitHub Actions.
  • get_job_logs Obtém os logs de um job de workflow GitHub Actions.
  • get_code_scanning_alert Obtém um alerta de code scanning.
  • list_code_scanning_alerts Lista alertas de code scanning.
  • get_me Obtém o perfil do utilizador autenticado.
  • get_team_members Obtém os membros de uma equipa.
  • get_teams Obtém equipas.
  • assign_copilot_to_issue Atribui o Copilot a uma issue.
  • request_copilot_review Pede uma revisão ao Copilot.
  • get_dependabot_alert Obtém um alerta Dependabot.
  • list_dependabot_alerts Lista alertas Dependabot.
  • get_discussion Obtém uma discussion.
  • get_discussion_comments Obtém comentários de uma discussion.
  • list_discussion_categories Lista categorias de discussions.
  • list_discussions Lista discussions.
  • create_gist Cria um Gist.
  • get_gist Obtém o conteúdo de um Gist.
  • list_gists Lista Gists.
  • update_gist Atualiza um Gist.
  • get_repository_tree Obtém a árvore do repositório.
  • add_issue_comment Adiciona um comentário a uma issue.
  • get_label Obtém uma etiqueta específica de um repositório.
  • issue_read Obtém detalhes de uma issue.
  • issue_write Cria ou atualiza uma issue.
  • list_issue_types Lista os tipos de issue disponíveis.
  • list_issues Lista issues.
  • search_issues Pesquisa issues.
  • sub_issue_write Altera uma sub-issue.
  • get_label Obtém uma etiqueta específica de um repositório.
  • label_write Operações de escrita em etiquetas do repositório.
  • list_label Lista etiquetas de um repositório.
  • dismiss_notification Dispensa uma notificação.
  • get_notification_details Obtém detalhes de uma notificação.
  • list_notifications Lista notificações.
  • manage_notification_subscription Gere a subscrição de uma notificação.
  • manage_repository_notification_subscription Gere a subscrição de notificações de um repositório.
  • mark_all_notifications_read Marca todas as notificações como lidas.
  • search_orgs Pesquisa organizações.
  • projects_get Obtém detalhes de recursos do GitHub Projects.
  • projects_list Lista recursos do GitHub Projects.
  • projects_write Modifica itens de um GitHub Project.
  • add_comment_to_pending_review Adiciona um comentário de revisão à revisão pendente mais recente do autor.
  • add_reply_to_pull_request_comment Responde a um comentário de pull request.
  • create_pull_request Abre um novo pull request.
  • list_pull_requests Lista pull requests.
  • merge_pull_request Faz merge de um pull request.
  • pull_request_read Obtém detalhes de um pull request.
  • pull_request_review_write Operações de escrita (criar, submeter, apagar) em revisões de pull request.
  • search_pull_requests Pesquisa pull requests.
  • update_pull_request Edita um pull request.
  • update_pull_request_branch Atualiza a branch de um pull request.
  • create_branch Cria uma branch.
  • create_or_update_file Cria ou atualiza um ficheiro.
  • create_repository Cria um repositório.
  • delete_file Apaga um ficheiro.
  • fork_repository Faz fork de um repositório.
  • get_commit Obtém detalhes de um commit.
  • get_file_contents Obtém o conteúdo de um ficheiro ou diretório.
  • get_latest_release Obtém a release mais recente.
  • get_release_by_tag Obtém uma release pelo nome da tag.
  • get_tag Obtém detalhes de uma tag.
  • list_branches Lista branches.
  • list_commits Lista commits.
  • list_releases Lista releases.
  • list_tags Lista tags.
  • push_files Faz push de ficheiros para o repositório.
  • search_code Pesquisa código.
  • search_repositories Pesquisa repositórios.
  • get_secret_scanning_alert Obtém um alerta de secret scanning.
  • list_secret_scanning_alerts Lista alertas de secret scanning.
  • get_global_security_advisory Obtém um global security advisory.
  • list_global_security_advisories Lista global security advisories.
  • list_org_repository_security_advisories Lista security advisories de repositórios de uma organização.
  • list_repository_security_advisories Lista security advisories de um repositório.
  • list_starred_repositories Lista repositórios com estrela.
  • star_repository Dá estrela a um repositório.
  • unstar_repository Remove estrela de um repositório.
  • search_users Pesquisa utilizadores.
  • create_pull_request_with_copilot Executa uma tarefa com o agente de código GitHub Copilot.
  • get_copilot_space Obtém um Copilot Space.
  • list_copilot_spaces Lista Copilot Spaces.
  • github_support_docs_search Obtém documentação relevante para responder a questões de produto e suporte da GitHub. Tópicos: GitHub Actions Workflows, Authentication, GitHub Support Inquiries, Pull Request Practices, Repository Maintenance, GitHub Pages, GitHub Packages, GitHub Discussions, Copilot Spaces.
Algo incorreto? Ajuda-nos a melhorar