Servidor MCP de Acciones de GitHub

Servidor MCP para la API de GitHub Actions, que permite a los asistentes de IA gestionar y operar flujos de trabajo de GitHub Actions. Compatible con múltiples asistentes de programación de IA, como Claude Desktop, Codeium y Windsurf.

Características

• Gestión completa del flujo de trabajo : enumerar, visualizar, activar, cancelar y volver a ejecutar flujos de trabajo

• Análisis de ejecución del flujo de trabajo : obtenga información detallada sobre las ejecuciones del flujo de trabajo y sus trabajos

• Manejo integral de errores : mensajes de error claros con detalles mejorados

• Validación de tipos flexible : verificación de tipos robusta con manejo elegante de variaciones de API

• Diseño centrado en la seguridad : gestión del tiempo de espera, limitación de velocidad y validación estricta de URL

Herramientas

1. list_workflows

   • Enumerar flujos de trabajo en un repositorio de GitHub

   • Entradas:

     • owner (cadena): propietario del repositorio (nombre de usuario u organización)

     • repo (cadena): nombre del repositorio

     • page (número opcional): Número de página para paginación

     • perPage (número opcional): Resultados por página (máximo 100)

   • Devuelve: Lista de flujos de trabajo en el repositorio

2. get_workflow

   • Obtener detalles de un flujo de trabajo específico

   • Entradas:

     • owner (cadena): propietario del repositorio (nombre de usuario u organización)

     • repo (cadena): nombre del repositorio

     • workflowId (cadena o número): el ID del flujo de trabajo o nombre de archivo

   • Devoluciones: Información detallada sobre el flujo de trabajo

3. get_workflow_usage

   • Obtener estadísticas de uso de un flujo de trabajo

   • Entradas:

     • owner (cadena): propietario del repositorio (nombre de usuario u organización)

     • repo (cadena): nombre del repositorio

     • workflowId (cadena o número): el ID del flujo de trabajo o nombre de archivo

   • Devoluciones: Estadísticas de uso, incluidos los minutos facturables

4. list_workflow_runs

   • Enumere todas las ejecuciones de flujo de trabajo para un repositorio o un flujo de trabajo específico

   • Entradas:

     • owner (cadena): propietario del repositorio (nombre de usuario u organización)

     • repo (cadena): nombre del repositorio

     • workflowId (cadena o número opcional): el ID del flujo de trabajo o el nombre del archivo

     • actor (cadena opcional): Filtrar por usuario que activó el flujo de trabajo

     • branch (cadena opcional): Filtrar por rama

     • event (cadena opcional): Filtrar por tipo de evento

     • status (cadena opcional): Filtrar por estado

     • created (cadena opcional): Filtrar por fecha de creación (AAAA-MM-DD)

     • excludePullRequests (booleano opcional): Excluye ejecuciones activadas por PR

     • checkSuiteId (número opcional): Filtrar por ID de suite de verificación

     • page (número opcional): Número de página para paginación

     • perPage (número opcional): Resultados por página (máximo 100)

   • Devoluciones: Lista de ejecuciones de flujo de trabajo que coinciden con los criterios

5. get_workflow_run

   • Obtener detalles de una ejecución de flujo de trabajo específica

   • Entradas:

     • owner (cadena): propietario del repositorio (nombre de usuario u organización)

     • repo (cadena): nombre del repositorio

     • runId (número): El ID de la ejecución del flujo de trabajo

   • Devoluciones: Información detallada sobre la ejecución del flujo de trabajo específico

6. get_workflow_run_jobs

   • Obtener trabajos para una ejecución de flujo de trabajo específica

   • Entradas:

     • owner (cadena): propietario del repositorio (nombre de usuario u organización)

     • repo (cadena): nombre del repositorio

     • runId (número): El ID de la ejecución del flujo de trabajo

     • filter (cadena opcional): filtrar trabajos por estado de finalización ('más reciente', 'todos')

     • page (número opcional): Número de página para paginación

     • perPage (número opcional): Resultados por página (máximo 100)

   • Devuelve: Lista de trabajos en la ejecución del flujo de trabajo

7. trigger_workflow

   • Activar una ejecución de flujo de trabajo

   • Entradas:

     • owner (cadena): propietario del repositorio (nombre de usuario u organización)

     • repo (cadena): nombre del repositorio

     • workflowId (cadena o número): el ID del flujo de trabajo o nombre de archivo

     • ref (cadena): La referencia para ejecutar el flujo de trabajo (rama, etiqueta o SHA)

     • inputs (objeto opcional): parámetros de entrada para el flujo de trabajo

   • Devoluciones: Información sobre la ejecución del flujo de trabajo activado

8. cancel_workflow_run

   • Cancelar una ejecución de flujo de trabajo

   • Entradas:

     • owner (cadena): propietario del repositorio (nombre de usuario u organización)

     • repo (cadena): nombre del repositorio

     • runId (número): El ID de la ejecución del flujo de trabajo

   • Devoluciones: Estado de la operación de cancelación

9. rerun_workflow

   • Volver a ejecutar una ejecución de flujo de trabajo

   • Entradas:

     • owner (cadena): propietario del repositorio (nombre de usuario u organización)

     • repo (cadena): nombre del repositorio

     • runId (número): El ID de la ejecución del flujo de trabajo

   • Devuelve: Estado de la operación de re-ejecución

Uso con asistentes de codificación de IA

Este servidor MCP es compatible con múltiples asistentes de codificación de IA, incluidos Claude Desktop, Codeium y Windsurf.

Escritorio de Claude

Primero, asegúrese de haber compilado el proyecto (consulte la sección "Compilación" más abajo). Luego, agregue lo siguiente a su claude_desktop_config.json :

Codeio

Agregue la siguiente configuración a su archivo de configuración Codeium MCP (normalmente en ~/.codeium/windsurf/mcp_config.json en sistemas basados en Unix o %USERPROFILE%\.codeium\windsurf\mcp_config.json en Windows):

Windsurf

Windsurf utiliza el mismo formato de configuración que Codeium. Añada el servidor a su configuración de Windsurf MCP como se muestra arriba para Codeium.

Construir

Unix/Linux/macOS

Clonar el repositorio y compilar:

Ventanas

Para sistemas Windows, utilice el comando de compilación específico de Windows:

Alternativamente, puede utilizar el archivo por lotes incluido:

Esto creará los archivos necesarios en el directorio dist que necesitará para ejecutar el servidor MCP.

Instrucciones específicas de Windows

Prerrequisitos

• Node.js (v14 o superior)

• npm (v6 o superior)

Ejecución del servidor en Windows

1. Usando el archivo por lotes (método más simple):

   run-server.bat [optional-github-token]

   Esto verificará si la compilación existe, la compilará si es necesario e iniciará el servidor.

2. Usando npm directamente:

   npm run start

Configuración del token de acceso personal de GitHub en Windows

Para obtener una funcionalidad completa y evitar la limitación de velocidad, debe configurar su token de acceso personal de GitHub.

Opciones:

1. Páselo como parámetro al archivo por lotes:

   run-server.bat your_github_token_here

2. Establezcalo como una variable de entorno:

   set GITHUB_PERSONAL_ACCESS_TOKEN=your_github_token_here npm run start

Solución de problemas de Windows

Si encuentra problemas:

1. Errores de compilación : asegúrese de que TypeScript esté instalado correctamente.

   npm install -g typescript

2. Problemas de permisos : asegúrese de estar ejecutando los comandos en un símbolo del sistema con los permisos adecuados.

3. Errores de Node.js : verifique que esté usando una versión de Node.js compatible.

   node --version

Ejemplos de uso

Enumerar flujos de trabajo en un repositorio:

Activar un flujo de trabajo:

Solución de problemas

Problemas comunes

1. Errores de autenticación :

   • Asegúrese de que su token de GitHub tenga los permisos correctos

   • Compruebe que el token esté configurado correctamente como variable de entorno

2. Limitación de velocidad :

   • El servidor implementa una limitación de velocidad para evitar alcanzar los límites de la API de GitHub

   • Si encuentra errores de límite de velocidad, reduzca la frecuencia de las solicitudes

3. Errores de validación de tipo :

   • Las respuestas de la API de GitHub a veces pueden diferir de los esquemas esperados

   • El servidor implementa una validación flexible para manejar la mayoría de las variaciones

   • Si encuentra errores persistentes, abra un problema.

Licencia

Este servidor MCP tiene licencia MIT.