Servidor MCP de GitHub

Una implementación de servidor de Protocolo de contexto de modelo (MCP) para interactuar con problemas de GitHub a través de Cline.

Características

Enumerar problemas de GitHub desde un repositorio
Crear nuevos problemas en GitHub
Manejo de errores y validación
Autenticación segura mediante variables de entorno

Related MCP server: GitHub MCP Server

Instalación

Clonar el repositorio:

git clone https://github.com/timbuchinger/mcp-github.git cd mcp-github

Instalar dependencias con uv:

pip install uv uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate uv pip install -r requirements.txt

Copia la plantilla de entorno y configura tu token de GitHub:

cp .env.template .env

Edite .env y agregue su token de acceso personal de GitHub:

GITHUB_TOKEN=your_token_here

Para crear un token de acceso personal de GitHub:

Vaya a Configuración de GitHub -> Configuración de desarrollador -> Tokens de acceso personal
Generar un nuevo token con alcance repo
Copia el token y pégalo en tu archivo .env

Uso

Ejecute el servidor MCP:

python -m src.mcp_github.server

El servidor se iniciará y expondrá dos herramientas a Cline:

obtener_problemas

Obtenga una lista de problemas de un repositorio de GitHub:

{ "repo": "owner/repo" }

crear_problema

Crear un nuevo problema en un repositorio de GitHub:

{ "repo": "owner/repo", "title": "Issue title", "body": "Issue description" }

Manejo de errores

El servidor maneja errores comunes:

Token de GitHub faltante
Nombre de repositorio no válido
Faltan parámetros requeridos
Errores de la API de GitHub

Las respuestas de error incluyen mensajes descriptivos para ayudar a solucionar problemas.

Desarrollo

El proyecto utiliza uv para la gestión de dependencias. Para configurar un entorno de desarrollo:

# Install all dependencies (including dev dependencies) uv pip install -r requirements.txt # Run tests pytest # Format code black . # Type checking mypy .