GitHub MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Allows to list and create GitHub issues from a repository

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

Instalación

  1. Clonar el repositorio:
git clone https://github.com/timbuchinger/mcp-github.git cd mcp-github
  1. Instalar dependencias con uv:
pip install uv uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate uv pip install -r requirements.txt
  1. 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 .
-
security - not tested
F
license - not found
-
quality - not tested

Permite la interacción con problemas de GitHub a través del Protocolo de contexto de modelo, lo que permite a los usuarios enumerar y crear problemas con autenticación segura.

  1. Features
    1. Installation
      1. Usage
        1. get_issues
        2. create_issue
      2. Error Handling
        1. Development
          ID: j37nzp7f8j