GitHub MCP Server (Custom)

Un servidor personalizado del Model Context Protocol (MCP) que le da a un agente de IA acceso CRUD completo a GitHub: repositorios, incidencias, solicitudes de extracción, ramas, comentarios, revisiones y fusiones. Construido con el SDK oficial de Python mcp (FastMCP) y la API REST de GitHub mediante httpx.

23 herramientas en total — consulta server.py para la lista completa. Destacados:

Configuración

1. Instala las dependencias

   pip install -r requirements.txt

2. Crea un token de GitHub

   Ve a https://github.com/settings/tokens y crea uno de los siguientes:

   • un PAT clásico con el alcance repo, o

   • un PAT de grano fino con Contents, Issues, Pull requests y Metadata configurados como Lectura y escritura, con alcance a los repositorios que quieras que el agente toque.

3. Establece el token como variable de entorno

   export GITHUB_TOKEN=ghp_your_token_here

4. Ejecútalo de forma independiente (verificación de cordura opcional)

   python server.py

   Se quedará esperando a que un cliente MCP se conecte a través de stdio — eso es lo esperado, no es un servidor web.

Related MCP server: github-mcp

Conectándolo a Claude Desktop

Añade esto a tu claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json en Windows, ~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

{
  "mcpServers": {
    "github": {
      "command": "python",
      "args": ["/absolute/path/to/server.py"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

Reinicia Claude Desktop y las herramientas de GitHub aparecerán en el selector de herramientas.

Conectándolo a tu propio pipeline de agente (por ejemplo, el proyecto Jira → GitHub → Teams)

Dado que es un servidor MCP stdio estándar, cualquier cliente o SDK compatible con MCP puede lanzarlo como subproceso y comunicarse con él a través de stdin/stdout — incluyendo un host .NET si usas el SDK de MCP para C#, o los SDK de Python/TypeScript si tu orquestador es políglota. Apunta el cliente a:

command: python
args: ["/absolute/path/to/server.py"]
env: { "GITHUB_TOKEN": "<token>" }

Ampliándolo

Para añadir una nueva herramienta, solo añade una nueva función decorada con @mcp.tool() a server.py que llame a _request(method, path, ...) contra la API REST de GitHub. El docstring se convierte en la descripción de la herramienta que se muestra al modelo, y las sugerencias de tipo se convierten en el esquema de entrada — así que mantén ambos precisos.

Notas

• Todas las operaciones de escritura (create_*, update_*, delete_*, merge_*) hacen cambios reales en GitHub — no hay modo de prueba en seco. Considera probar primero contra un repositorio de prueba, especialmente merge_pull_request y delete_branch.

• Los límites de tasa siguen los límites estándar de la API REST de GitHub (5,000 solicitudes/hora para solicitudes autenticadas al momento de escribir esto) — el servidor no hace su propia limitación.

• Los errores de GitHub (autenticación incorrecta, 404, conflictos de fusión, etc.) se lanzan como RuntimeError con el cuerpo de respuesta de la API incluido, para que el agente que llama reciba un mensaje legible al que reaccionar.