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?"

Related MCP server: GitHub MCP Server

🌟 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

Recursos

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.

1. Bifurcar el repositorio

2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )

3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )

4. Empujar a la rama ( git push origin feature/amazing-feature )

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