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

1. Clonar el repositorio:

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

2. Instalar dependencias con uv:

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

3. 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:

1. Vaya a Configuración de GitHub -> Configuración de desarrollador -> Tokens de acceso personal

2. Generar un nuevo token con alcance repo

3. 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 .