Sobre o projeto

O GitHub MCP Server é a implementação oficial do Model Context Protocol (MCP) do GitHub, projetada para conectar ferramentas de IA diretamente à plataforma do GitHub. Ele permite que agentes de IA, assistentes e chatbots leiam repositórios e arquivos de código, gerenciem issues e pull requests, analisem código e automatizem fluxos de trabalho por meio de interações em linguagem natural. Os principais casos de uso incluem gerenciamento de repositórios (navegar e consultar código, pesquisar arquivos, analisar commits, entender a estrutura do projeto), automação de issues e PRs (criar, atualizar, fazer triagem de bugs, revisar alterações, manter quadros de projeto), inteligência de CI/CD e fluxo de trabalho (monitorar execuções do GitHub Actions, analisar falhas de build, gerenciar releases), análise de código (examinar descobertas de segurança, revisar alertas do Dependabot, entender padrões de código) e colaboração em equipe (acessar discussões, gerenciar notificações, analisar a atividade da equipe). Duas opções de implantação estão disponíveis. O GitHub MCP Server remoto é hospedado pelo GitHub e oferece a configuração mais simples, exigindo um host MCP compatível com suporte a servidor remoto (VS Code 1.101+, Claude Desktop, Cursor, Windsurf e outros). Ele suporta autenticação OAuth ou Personal Access Token, com botões de instalação em um clique para VS Code, VS Code Insiders e Visual Studio. Um modo insiders fornece acesso antecipado a recursos experimentais por meio de caminho de URL ou cabeçalho. O GitHub Enterprise Cloud com residência de dados (ghe.com) é suportado; o GitHub Enterprise Server requer a versão local. O GitHub MCP Server local é executado via Docker (imagem em ghcr.io/github/github-mcp-server) ou pode ser compilado a partir do código-fonte com Go. Ele suporta login OAuth no github.com (token mantido apenas em memória) ou autenticação PAT via GITHUB_PERSONAL_ACCESS_TOKEN, que tem precedência sobre OAuth. A flag --gh-host e a variável de ambiente GITHUB_HOST configuram o GitHub Enterprise Server ou Enterprise Cloud com residência de dados, com HTTPS aplicado exceto para hosts de loopback. A configuração de ferramentas é flexível. A flag --toolsets ou a variável de ambiente GITHUB_TOOLSETS habilita ou desabilita grupos de funcionalidades, ajudando os LLMs na escolha de ferramentas e reduzindo o tamanho do contexto. Ferramentas individuais podem ser especificadas via --tools ou GITHUB_TOOLS, e podem ser combinadas aditivamente com toolsets. Um modo somente leitura ignora ferramentas de escrita. Toolsets especiais incluem "all" (habilita tudo) e "default" (context, repos, issues, pull_requests, users). Um modo insiders está disponível localmente via --insiders ou GITHUB_INSIDERS=true. Os guias de instalação cobrem muitos hosts MCP, incluindo Copilot CLI, GitHub Copilot no JetBrains/Visual Studio/Eclipse/Xcode, Claude Desktop e Claude Code, OpenAI Codex, Cursor, OpenCode, Windsurf, Zed, Rovo Dev CLI e Google Gemini CLI. O projeto inclui documentação sobre políticas e governança, login OAuth, autenticação de GitHub App, renomeação de ferramentas, configuração do servidor e configuração do servidor remoto.