Depurador de flujo de trabajo de GitHub (MCP)

Una utilidad de opción múltiple (MCP) para diagnosticar y corregir fallas en el flujo de trabajo de Acciones de GitHub mediante la API de GitHub.

Descripción general

Esta herramienta ayuda a los usuarios a diagnosticar y corregir errores del flujo de trabajo de GitHub Actions mediante un árbol de decisiones estructurado. Utiliza la API de GitHub para obtener información sobre la ejecución del flujo de trabajo, analizar errores y ofrecer soluciones prácticas.

Related MCP server: GitHub MCP Server

Características

• Obtener ejecuciones de flujo de trabajo fallidas recientes para un repositorio

• Analizar trabajos y pasos de ejecución del flujo de trabajo

• Identificar patrones de falla comunes

• Sugerir soluciones específicas para problemas comunes

• Ver y actualizar archivos de flujo de trabajo

Instalación

Instalación mediante herrería

Para instalar githubworkflowmcp para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @Maxteabag/githubworkflowmcp --client claude

Instalación manual

# Clone the repository
git clone https://github.com/yourusername/github-workflow-debugger-mcp.git
cd github-workflow-debugger-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Link the binary for local use
npm link

Uso

El Depurador de Flujo de Trabajo de GitHub (MCP) está diseñado para usarse con asistentes de IA compatibles con el Protocolo de Contexto de Modelo (MCP). Ofrece varias herramientas para diagnosticar y corregir errores del flujo de trabajo de GitHub Actions.

Permisos requeridos

Para utilizar esta herramienta, necesitará un token de acceso personal (PAT) de GitHub con los siguientes permisos:

• repo - Control total de repositorios privados

• workflow - Actualizar flujos de trabajo de acciones de GitHub

Debes configurar este token como una variable de entorno llamada GITHUB_PERSONAL_ACCESS_TOKEN .

Configuración

Al utilizar esta herramienta con un cliente compatible con MCP, puede configurarla de la siguiente manera:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Reemplace <YOUR_TOKEN> con su token de acceso personal de GitHub.

Herramientas disponibles

1. get-failed-workflow-runs : recupera ejecuciones de flujo de trabajo fallidas recientes para un repositorio

2. get-workflow-run-jobs : obtiene trabajos para una ejecución de flujo de trabajo específica

3. get-workflow-file : recupera el contenido de un archivo de flujo de trabajo

4. update-workflow-file : actualiza un archivo de flujo de trabajo con correcciones

5. Analyze-Workflow-Failure : analiza una ejecución de flujo de trabajo fallida y sugiere soluciones.

Ejemplo de uso

A continuación se muestra un ejemplo de cómo utilizar el depurador de flujo de trabajo de GitHub MCP con un asistente de IA:

1. Primero, obtenga las ejecuciones de flujo de trabajo fallidas recientes:

   I need to check recent failed workflow runs for my repository "username/repo".

2. Analizar una ejecución fallida específica:

   Can you analyze workflow run #123456 and suggest fixes?

3. Ver el archivo de flujo de trabajo:

   Show me the content of the workflow file at .github/workflows/main.yml

4. Actualice el archivo de flujo de trabajo con correcciones:

   Update the workflow file with the suggested fixes.

Desarrollo

Prerrequisitos

• Node.js 16 o superior

• npm o hilo

Configuración

# Install dependencies
npm install

# Build the project
npm run build

Estructura del proyecto

• src/index.ts - Punto de entrada principal para el servidor MCP

• build/ - Archivos JavaScript compilados

Licencia

ISC