Puente MCP de GitHub

MCP GITHUB ENTERPRISE 🌉

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a los agentes de IA (Claude, ChatGPT, etc.) consultar los datos de licencias de GitHub Enterprise. Obtenga de forma segura resúmenes de licencias, detalles por usuario, membresías de organizaciones y roles empresariales mediante el punto de conexión /consumed-licenses .

📊 Capacidades y ejemplos de indicaciones

Resumen de la licencia
• "Show me our GitHub Enterprise license summary"
• "How many licenses are we currently using?"
Uso detallado de la licencia
• "List all consumed GitHub licenses"
• "Do we have any unused GitHub licenses?"
Búsqueda de usuarios
• "What GitHub orgs does johndoe belong to?"
• "What enterprise roles does johndoe have?"
• "Is johndoe an owner in our enterprise?"
• "Get detailed info about johndoe"
• "Does johndoe have 2FA enabled?"

🌟 Características

Análisis de licencias : Asientos totales vs. asientos consumidos
Búsqueda de usuarios : membresías de la organización, roles, 2FA, ID SAML
Paginación : Gestiona grandes empresas de forma automática
Transportes duales : stdio para MCP directo, SSE para HTTP
Listo para Kubernetes : Implemente en EKS/GKE o cualquier clúster de K8s

📋 Requisitos previos

Python 3.9+
PAT de GitHub con alcances read:enterprise /licencia
Inquilino de GitHub Enterprise Cloud

🚀 Inicio rápido

1. Clonar e instalar

git clone https://github.com/vipink1203/mcp-github-enterprise.git
cd mcp-github-enterprise
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2. Configurar

cp .env.example .env
# Edit .env: set GITHUB_TOKEN and GITHUB_ENTERPRISE_URL

3. Correr

transporte de stdio

export TRANSPORT=stdio
python main.py

Transporte SSE

export TRANSPORT=sse PORT=8050
python main.py

🐳 Docker y n8n

Agregue este servicio a su docker-compose.yml junto con n8n:

services:
  github-mcp:
    image: ghcr.io/vipink1203/mcp-github-enterprise:latest
    environment:
      - GITHUB_TOKEN=${GITHUB_TOKEN}
      - GITHUB_ENTERPRISE_URL=${GITHUB_ENTERPRISE_URL}
      - TRANSPORT=sse
      - PORT=8050
    ports:
      - "8050:8050"
    restart: unless-stopped
    networks:
      - n8n-network

En la interfaz de usuario de n8n, habilite el cliente MCP:

Configuración → Credenciales → Nueva credencial
Elija la API del cliente MCP y configure la URL en http://github-mcp:8050/sse

🔌 Configuración del cliente

Claude Desktop / Windsurf / Cursor

Añade esta configuración a la configuración de Claude Desktop:

{
  "mcpServers": {
   "github-ent": {
     "command": "/path/to/your/venv/python",
     "args": ["/path/to/main.py"],
     "env": {
       "GITHUB_TOKEN": "",
       "GITHUB_ENTERPRISE_URL": "https://api.github.com/enterprises/{enterprise_name}",
       "TRANSPORT": "stdio"
     }
   }
}

Configuración de SSE

{
  "mcpServers": {
    "github": {
      "transport": "sse",
      "url": "http://localhost:8050/sse"
    }
  }
}

📊 Casos de uso de ejemplo

Gestión de usuarios empresariales : automatice la incorporación y salida de usuarios
Monitoreo de licencias : reciba alertas cuando las licencias estén cerca de vencer
Análisis organizacional : Analizar las estructuras y relaciones organizacionales.
Auditoría de acceso de usuarios : realice un seguimiento de los permisos de los usuarios y los niveles de acceso
GitHub Insights con tecnología de IA : permita que la IA analice los datos de GitHub de su empresa

Herramientas y recursos de MCP

Herramientas

Nombre	Descripción
`list_consumed_licenses`	Resumir licencias, incluir usuarios opcionalmente
`get_user_organizations`	Enumerar las membresías de la organización de GitHub de un usuario
`get_user_enterprise_roles`	Enumerar los roles empresariales de un usuario
`get_user_detail`	Detalle completo de la licencia para un usuario

Recursos

URI	Descripción
`github://consumed-licenses/{dummy}`	Uso completo de la licencia + detalles del usuario
`github://user/{username}/roles`	Roles de organización y empresa para un usuario

Consideraciones de seguridad

Almacene su token de GitHub de forma segura
Utilice alcances apropiados para su token de GitHub
Para producción, considere usar AWS Secrets Manager o similar
Implementar políticas de red en implementaciones de Kubernetes

🤝 Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add some amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción

📜 Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

🙏 Agradecimientos

Protocolo de contexto de modelo para el SDK de Python
MCP-Mem0 por proporcionar una excelente estructura de plantilla
API de GitHub para la API completa

Creado con ❤️ para una integración perfecta con IA ↔️ GitHub Enterprise.

GitHub MCP Bridge

Integrations