GitHub MCP

Un conector MCP remoto, genérico y de solo lectura para consultar repositorios de GitHub seleccionados mediante una instalación de GitHub App. Está diseñado para autoalojamiento y no contiene identificadores de cuentas de GitHub, Cloudflare ni de clientes MCP.

El conector utiliza dos capas de autorización:

1. Un usuario autoriza la GitHub App para demostrar su identidad de GitHub. Solo los usuarios configurados por el operador pueden completar la conexión.

2. Las llamadas de herramienta usan tokens de instalación de la GitHub App de corta duración, restringidos al repositorio instalado solicitado.

El token de usuario de GitHub se descarta después de la verificación de identidad. El conector no expone herramientas de escritura.

Capacidades

• Descubrir repositorios seleccionados en instalaciones de GitHub App.

• Buscar código y recuperar archivos de texto o listados de directorios.

• Inspeccionar commits, pull requests, diffs, revisiones y comentarios.

• Inspeccionar issues y comentarios de issues.

• Autenticar clientes MCP remotos mediante OAuth, PKCE y Dynamic Client Registration.

Related MCP server: GitHub Code Search MCP Server

Desarrollo local

Requisitos: Node.js 22 o superior y Yarn 1.22.

yarn install
yarn type-check
yarn lint
yarn test
yarn build

Las pruebas usan identidades falsas y servicios simulados de GitHub. No se necesita una cuenta de GitHub App ni de Cloudflare para la verificación local.

Para ejecutar el Worker con servicios reales, sigue la guía de configuración del operador. No hagas commit de wrangler.jsonc, secretos locales ni claves privadas de la GitHub App.

Herramientas MCP

Los resultados son respuestas en vivo de la API de GitHub, normalizadas en JSON limitado con URLs canónicas de GitHub. La paginación por defecto es de 20 elementos y tiene un máximo de 50. La salida de texto y de diff tiene un tope de 100 000 caracteres.

Modelo de seguridad

• La variable AUTHORIZED_GITHUB_LOGINS es obligatoria y falla en modo cerrado cuando está vacía.

• Las instalaciones de la GitHub App determinan qué repositorios existen para el conector.

• Cada llamada de herramienta sobre un repositorio emite un token de una hora restringido a ese repositorio.

• Los permisos requeridos de la GitHub App son de solo lectura: Metadata, Contents, Issues y Pull Requests.

• Los códigos OAuth, los tokens de usuario, los tokens de instalación, los secretos de cliente y las claves privadas nunca se devuelven ni se registran intencionalmente.

Este proyecto está pensado como un conector personal o para equipos pequeños, no como un servicio alojado multi-tenant.

Licencia

Este proyecto está disponible bajo la MIT License.