GitHub Copilot Usage MCP Server

Um servidor MCP (Model Context Protocol) para obter informações de uso atual do GitHub Copilot, incluindo cotas, limites e estatísticas de uso.

Instalação

Via NPM

Instalação Local para Desenvolvimento

Como Obter o Token do Copilot

Para usar este MCP server, você precisa do token de acesso do GitHub Copilot. Existem algumas formas de obtê-lo:

Método 1: Através do VS Code

1. Abra o VS Code com a extensão GitHub Copilot instalada

2. Pressione Ctrl+Shift+P (ou Cmd+Shift+P no Mac)

3. Digite "Developer: Open Webview Developer Tools"

4. Na aba Network, faça uma requisição que utilize o Copilot

5. Procure por requisições para api.github.com/copilot_internal

6. Copie o valor do header Authorization (remova o "token " do início)

Método 2: Através de Ferramentas de Desenvolvimento

Você pode usar ferramentas como mitmproxy ou interceptar requisições do VS Code para capturar o token.

Método 3 (Recomendado): Através do Arquivo de Configuração (Neovim, JetBrains, etc.)

As extensões oficiais do Copilot para várias IDEs (incluindo Neovim com copilot.lua e a suíte JetBrains) armazenam as informações de autenticação em um arquivo JSON local. Você pode extrair o token diretamente deste arquivo.

1. Localize e abra o arquivo: O arquivo geralmente está localizado em ~/.config/github-copilot/apps.json.

2. Encontre o token: Dentro do arquivo JSON, procure por uma chave chamada oauth_token. O valor associado a essa chave é o seu token de acesso.

   Você pode usar o seguinte comando no terminal para extrair o token rapidamente (requer a ferramenta jq):

   cat ~/.config/github-copilot/apps.json | jq -r '.[].oauth_token'

Uso com Agentes AI

Configuração para Claude Code

Configuração para Gemini CLI

Configuração para Claude Desktop / Cursor etc

Adicione ao seu arquivo de configuração do Claude Desktop (claude_desktop_config.json):

Ferramentas Disponíveis

get_copilot_usage

Obtém informações brutas de uso do GitHub Copilot em formato JSON.

get_copilot_usage_formatted

Obtém informações de uso do GitHub Copilot formatadas de forma legível em português.

get_copilot_usage_summary

Obtém um resumo conciso das informações principais de uso premium do GitHub Copilot.

Exemplos de Uso no Agent

Depois de configurado, você pode usar o MCP server em conversas com seu agent AI:

Estrutura do Projeto

Dependências

• @modelcontextprotocol/sdk: SDK oficial do MCP

Limitações e Considerações

⚠️ Este servidor utiliza um endpoint interno não documentado do GitHub (

• Não é uma API oficial: O endpoint pode ser alterado ou removido sem aviso

• Token temporário: O token expira e precisa ser renovado periodicamente (a não ser o utilizado pelo nvim ou jetbrains)

• Rate limiting: Pode haver limites de taxa nas requisições

• Termos de uso: Use por sua conta e risco, considerando os termos de serviço do GitHub

Contribuindo

1. Fork o projeto

2. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)

3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')

4. Push para a branch (git push origin feature/AmazingFeature)

5. Abra um Pull Request

Licença

Este projeto está licenciado sob a licença MIT - veja o arquivo LICENSE para detalhes.

Disclaimer

Este projeto é não oficial e não está afiliado ao GitHub ou à Microsoft. Use por sua conta e risco.