GitHub Repository Manager

Servidor MCP de GitHub Repository Manager

Un servidor de Model Context Protocol (MCP) que permite a los asistentes de IA crear y eliminar repositorios de GitHub.

Características

• ✅ Crear repositorios de GitHub con configuraciones personalizables
• ✅ Eliminar repositorios de GitHub (eliminación permanente)
• ✅ Compatible con el protocolo MCP - funciona con Claude Desktop y otros clientes MCP
• ✅ Configuración sencilla - solo configura y reinicia tu asistente de IA
• ✅ Seguro - utiliza variables de entorno para datos sensibles

Inicio Rápido

1. Instalar Dependencias

pip install -r requirements.txt

2. Configurar Tu Token de GitHub

1. Ve a Configuración de GitHub > Tokens
2. Genera un nuevo token con permisos de "repo"
3. Copia el token

3. Crear Archivo de Entorno

Crea un archivo .env en el mismo directorio que simple_mcp_server.py:

# .env file
GITHUB_TOKEN=your_actual_github_token_here

⚠️ Importante: ¡Nunca subas tu archivo .env a Git! Contiene información sensible.

4. Configurar Claude Desktop

1. Abre: ~/Library/Application Support/Claude/config.json
2. Reemplaza el contenido con:

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

Nota: Ya no es necesario configurar GITHUB_TOKEN en la configuración - se carga desde el archivo .env.

5. Reiniciar Claude Desktop

• Sal y vuelve a abrir Claude Desktop

6. ¡Pruébalo!

Pregunta a Claude:

• "¿Qué herramientas tienes disponibles?"
• "Crea un repositorio llamado 'my-test-repo'"
• "Elimina el repositorio llamado 'my-test-repo'"

Herramientas Disponibles

create_github_repository

Crea un nuevo repositorio de GitHub.

Parámetros:

• name (obligatorio): Nombre del repositorio
• private (opcional): Hazlo privado (por defecto: false)
• description (opcional): Descripción del repositorio
• auto_init (opcional): Inicializar con README (por defecto: true)

delete_github_repository

Elimina un repositorio existente de GitHub.

Parámetros:

• name (obligatorio): Nombre del repositorio a eliminar

Archivos

• simple_mcp_server.py - La implementación del servidor MCP
• requirements.txt - Dependencias de Python
• claude_config_example.json - Ejemplo de configuración de Claude Desktop
• .env.example - Archivo de entorno de ejemplo (copia a .env y agrega tu token)
• README.md - Este archivo

Notas de Seguridad

• ⚠️ Nunca subas tu archivo .env a Git
• ⚠️ Nunca subas tu token real de GitHub a Git
• ⚠️ La eliminación de repositorios es permanente
• ✅ Usa variables de entorno para datos sensibles
• ✅ Rota tus tokens regularmente
• ✅ Agrega .env a tu archivo .gitignore

Variables de Entorno

El servidor utiliza estas variables de entorno:

• GITHUB_TOKEN - Tu token de acceso personal de GitHub (obligatorio)

Solución de Problemas

Error "GITHUB_TOKEN no encontrado"

• Asegúrate de haber creado un archivo .env
• Verifica que GITHUB_TOKEN=your_token esté en el archivo .env
• Asegúrate de que el archivo .env esté en el mismo directorio que simple_mcp_server.py

Error "Repositorio no encontrado"

• Verifica que el nombre del repositorio sea correcto (distingue mayúsculas y minúsculas)
• Asegúrate de que tu token tenga los permisos adecuados
• Verifica que el repositorio exista en tu cuenta

El servidor MCP no carga

• Verifica la ruta del archivo en tu configuración
• Asegúrate de que el script sea ejecutable: chmod +x simple_mcp_server.py
• Reinicia Claude Desktop después de los cambios de configuración

Ejemplo de Uso

Una vez configurado, puedes pedirle a Claude:

• "Crea un repositorio privado llamado 'secret-project' con la descripción 'Mi proyecto secreto'"
• "Haz un repositorio público llamado 'open-source-tool'"
• "Elimina el repositorio llamado 'old-test-repo'"
• "¿Qué herramientas tienes disponibles?"

Licencia

Licencia MIT - ¡siéntete libre de usar y modificar! # MCP-Repo-Manager-