GitHub

Interaja com a API do GitHub para gerenciar repositórios, issues e pull requests.

GitHubExperimente este MCPPatrocinado

Documentação

Servidor MCP (Model Context Protocol) do GitHub

Olá! Este é um servidor MCP do GitHub projetado para permitir que LLMs compatíveis com MCP, como o Claude, se comuniquem com meu servidor MCP e interajam com a API do GitHub.

Requisitos

  • TypeScript (linguagem de programação)
  • Octokit (para fazer requisições à API do GitHub)
  • Model Context Protocol SDK

Configuração do projeto localmente

  1. Clone o repositório
  2. Execute npm install
  3. Adicione o arquivo .env observando o exemplo fornecido no arquivo .env.example
  4. Para compilar os arquivos TypeScript para Javascript, execute npx tsc
  5. Para finalmente executar o projeto, execute node build/index.js

Formas de testar

Você pode testar seu servidor MCP de 2 maneiras:

  • MCP inspector
  • Claude Desktop

Teste usando o MCP inspector

  1. Simplesmente execute npx @modelcontextprotocol/inspector node build/index.js no terminal
  2. Vá para http://localhost:5173
  3. Agora você pode ver o MCP inspector e testar.

Teste usando o Claude Desktop

  1. Baixe e instale o Claude Desktop a partir de aqui
  2. Vá em Arquivo > Configurações... > Desenvolvedor > Editar Configuração
  3. Deve abrir o local do arquivo claude_desktop_config.json.
  4. Abra esse arquivo no seu editor de código e adicione o seguinte: 
    {
 "mcpServers": {
   "gh": {
     "command": "node",
     "args": ["absolute\\path\\to\\your\\index.js\\file"],
     "env": {
       "GITHUB_TOKEN": "your-github-personal-access-token"
     }
   }
 }
}
  5. Saia e reabra o Claude Desktop

Funcionalidades

O MCP suporta principalmente dois recursos:

  • Ferramentas (4)
    • create-issue: criar uma nova issue em um repositório do GitHub
    • get-repo-info: obter informações sobre um repositório específico do GitHub
    • list-issues: listar issues em um repositório do GitHub
    • search-repos: Pesquisar repositórios do GitHub
  • Prompts (5)
    • create-issue-description: gerar uma descrição para uma issue do GitHub
    • create-pull-request-description: gerar uma descrição para um pull request do GitHub
    • search-repos-prompt: gerar uma consulta para pesquisar repositórios do GitHub
    • create-issue-prompt: gerar parâmetros para criar uma issue do GitHub
    • enhance-github-response: formatar e aprimorar dados brutos de resposta da API do GitHub

Você pode escrever seus próprios prompts ou selecionar um prompt adequado no menu suspenso na opção "Escolher uma integração" para MCP no Claude Desktop