GitHub MCP Server 🚀

Un servidor personalizado del Protocolo de Contexto de Modelo (MCP) construido con Node.js y TypeScript. Este servidor permite que cualquier asistente de IA compatible con MCP (como Gemini Code Assist, Claude Desktop, Roo Code, etc.) interactúe directamente con tu cuenta de GitHub.

✨ Características (Herramientas disponibles)

Este servidor expone 7 herramientas potentes a tu asistente de IA:

1. create_repository: Crea un repositorio nuevo, público o privado.

2. get_my_repositories: Lista los repositorios más recientemente actualizados del usuario autenticado.

3. get_repository: Obtiene los detalles de un repositorio específico.

4. get_file_content: Lee el contenido exacto de cualquier archivo dentro de un repositorio para análisis de código.

5. search_code: Busca funciones, palabras clave o sintaxis en los repositorios.

6. create_issue: Abre una nueva incidencia en un repositorio específico.

7. list_issues: Muestra las incidencias abiertas de un repositorio.

🛠️ Instalación y configuración

1. Clona el repositorio:

   git clone [https://github.com/YOUR_USERNAME/mcp-github-server.git](https://github.com/YOUR_USERNAME/mcp-github-server.git)
   cd mcp-github-server
   Install dependencies:

Bash npm install Compila el proyecto:

Bash npm run build

🔑 Cómo obtener tu token de GitHub

Para permitir que este servidor actúe en tu nombre, necesitas un Token de Acceso Personal (PAT) de GitHub.

Ve a la configuración de tu cuenta de GitHub.

Navega a Configuración de desarrollador (al final de la barra lateral izquierda).

Haz clic en Tokens de acceso personal -> Tokens (clásico).

Haz clic en Generar nuevo token (clásico).

Dale a tu token una nota (por ejemplo, "MCP Server").

Ámbitos requeridos:

Marca la casilla repo (esto otorga control total de los repositorios privados, lo cual es necesario para crear repos, leer archivos y gestionar incidencias).

Desplázate hacia abajo y haz clic en Generar token.

Copia el token inmediatamente (empieza con ghp_...).

Configuración del entorno Crea un archivo .env en el directorio raíz de este proyecto:

Bash touch .env Añade tu token al archivo .env:

Fragmento de código GITHUB_TOKEN=your_generated_token_here 🔌 Conexión a tu IDE / Cliente de IA Para usar este servidor con un IDE o extensión compatible con MCP, debes configurar los ajustes MCP de tu cliente (normalmente un archivo mcp.json o mcp_config.json) para que apunten al archivo index.js compilado.

Configuración de ejemplo:

JSON { "mcpServers": { "github-mcp": { "command": "node", "args": [ "--no-warnings", "ABSOLUTE_PATH_TO_YOUR_PROJECT/dist/index.js" ], "env": { "GITHUB_TOKEN": "your_generated_token_here" } } } }

Nota: Asegúrate de reemplazar ABSOLUTE_PATH_TO_YOUR_PROJECT con la ruta real en tu máquina.

🤝 Contribuciones ¡Este es un pequeño proyecto educativo! Si deseas añadir más herramientas (como gestión de pull requests o lectura de commits), siéntete libre de hacer un fork del repositorio y enviar una Pull Request.