GitHub Repository Manager

Servidor MCP GitHub Repository Manager

Um servidor Model Context Protocol (MCP) que permite que assistentes de IA criem e excluam repositórios do GitHub.

Recursos

• ✅ Crie repositórios do GitHub com configurações personalizáveis
• ✅ Exclua repositórios do GitHub (exclusão permanente)
• ✅ Compatível com o protocolo MCP - funciona com Claude Desktop e outros clientes MCP
• ✅ Configuração simples - basta configurar e reiniciar seu assistente de IA
• ✅ Seguro - usa variáveis de ambiente para dados sensíveis

Início Rápido

1. Instale as Dependências

pip install -r requirements.txt

2. Configure Seu Token do GitHub

1. Vá para Configurações do GitHub > Tokens
2. Gere um novo token com permissões "repo"
3. Copie o token

3. Crie o Arquivo de Ambiente

Crie um arquivo .env no mesmo diretório que simple_mcp_server.py:

# .env file
GITHUB_TOKEN=your_actual_github_token_here

⚠️ Importante: Nunca envie seu arquivo .env para o Git! Ele contém informações sensíveis.

4. Configure o Claude Desktop

1. Abra: ~/Library/Application Support/Claude/config.json
2. Substitua o conteúdo por:

{
  "darkMode": "dark",
  "scale": 0,
  "mcpServers": {
    "github-repo-creator": {
      "command": "python3",
      "args": ["/path/to/your/simple_mcp_server.py"],
      "env": {}
    }
  }
}

Nota: Não é mais necessário definir GITHUB_TOKEN na configuração - ele é carregado do arquivo .env.

5. Reinicie o Claude Desktop

• Saia e reabra o Claude Desktop

6. Teste!

Pergunte ao Claude:

• "Quais ferramentas você tem disponíveis?"
• "Crie um repositório chamado 'my-test-repo'"
• "Exclua o repositório chamado 'my-test-repo'"

Ferramentas Disponíveis

create_github_repository

Cria um novo repositório do GitHub.

Parâmetros:

• name (obrigatório): Nome do repositório
• private (opcional): Torná-lo privado (padrão: falso)
• description (opcional): Descrição do repositório
• auto_init (opcional): Inicializar com README (padrão: verdadeiro)

delete_github_repository

Exclui um repositório existente do GitHub.

Parâmetros:

• name (obrigatório): Nome do repositório a excluir

Arquivos

• simple_mcp_server.py - A implementação do servidor MCP
• requirements.txt - Dependências Python
• claude_config_example.json - Exemplo de configuração do Claude Desktop
• .env.example - Exemplo de arquivo de ambiente (copie para .env e adicione seu token)
• README.md - Este arquivo

Notas de Segurança

• ⚠️ Nunca envie seu arquivo .env para o Git
• ⚠️ Nunca envie seu token real do GitHub para o Git
• ⚠️ A exclusão de repositórios é permanente
• ✅ Use variáveis de ambiente para dados sensíveis
• ✅ Rotacione seus tokens regularmente
• ✅ Adicione .env ao seu arquivo .gitignore

Variáveis de Ambiente

O servidor usa estas variáveis de ambiente:

• GITHUB_TOKEN - Seu token de acesso pessoal do GitHub (obrigatório)

Solução de Problemas

Erro "GITHUB_TOKEN não encontrado"

• Certifique-se de que você criou um arquivo .env
• Verifique se GITHUB_TOKEN=your_token está no arquivo .env
• Garanta que o arquivo .env esteja no mesmo diretório que simple_mcp_server.py

Erro "Repositório não encontrado"

• Verifique se o nome do repositório está correto (sensível a maiúsculas/minúsculas)
• Garanta que seu token tenha as permissões corretas
• Verifique se o repositório existe na sua conta

Servidor MCP não carrega

• Verifique o caminho do arquivo na sua configuração
• Garanta que o script seja executável: chmod +x simple_mcp_server.py
• Reinicie o Claude Desktop após alterações na configuração

Exemplo de Uso

Depois de configurado, você pode perguntar ao Claude:

• "Crie um repositório privado chamado 'secret-project' com a descrição 'Meu projeto secreto'"
• "Crie um repositório público chamado 'open-source-tool'"
• "Exclua o repositório chamado 'old-test-repo'"
• "Quais ferramentas você tem disponíveis?"

Licença

Licença MIT - sinta-se à vontade para usar e modificar! # MCP-Repo-Manager-