GitHub MCP Server

GitHub MCP Server

Uma implementação de servidor Model Context Protocol (MCP) para integração com o GitHub. Este servidor fornece ferramentas para interagir com a API do GitHub através do protocolo MCP.

Recursos

• Criar repositórios no GitHub
• Enviar conteúdo para repositórios
• Obter informações do usuário
• Tratamento adequado de erros e segurança de tipos em TypeScript
• Script de instalação automática

Pré-requisitos

• Node.js (v18 ou superior)
• npm (v8 ou superior)
• PowerShell (para instalação no Windows)
• Token de Acesso Pessoal do GitHub com escopo de repositório

Instalação

Windows

1. Clone este repositório:

git clone https://github.com/oghenetejiriorukpegmail/github-mcp.git

2. Execute o script de instalação:

.\install.ps1

O script irá:

• Criar os diretórios necessários
• Instalar as dependências
• Compilar o código TypeScript
• Configurar as configurações do MCP

Instalação Manual

1. Crie o diretório do MCP:

mkdir -p "$env:APPDATA\Roo-Code\MCP\github-mcp"

2. Clone este repositório nesse diretório:

git clone https://github.com/oghenetejiriorukpegmail/github-mcp.git "$env:APPDATA\Roo-Code\MCP\github-mcp"

3. Instale as dependências:

cd "$env:APPDATA\Roo-Code\MCP\github-mcp"
npm install

4. Compile o código TypeScript:

npm run build

5. Adicione a configuração do servidor ao arquivo de configurações do MCP em: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": [
        "%APPDATA%\Roo-Code\MCP\github-mcp\build\index.js"
      ],
      "env": {
        "GITHUB_TOKEN": "your-github-token-here"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Ferramentas Disponíveis

get_user

Obter informações do usuário do GitHub.

{
  "username": "octocat"
}

create_repo

Criar um novo repositório no GitHub.

{
  "repo_name": "my-new-repo",
  "description": "A new repository",
  "private": false
}

push_to_repo

Enviar conteúdo para um repositório do GitHub.

{
  "repo_name": "my-repo",
  "file_path": "docs/README.md",
  "content": "# My Project\nThis is a test file.",
  "message": "Add README file"
}

Desenvolvimento

1. Clone o repositório
2. Instale as dependências: npm install
3. Faça alterações em src/index.ts
4. Compile: npm run build
5. Teste suas alterações

Contribuindo

1. Faça um fork do repositório
2. Crie um branch de funcionalidade
3. Faça commit das suas alterações
4. Envie para o branch
5. Crie um Pull Request

Licença

MIT