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.

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

get-failed-workflow-runs : recupera ejecuciones de flujo de trabajo fallidas recientes para un repositorio
get-workflow-run-jobs : obtiene trabajos para una ejecución de flujo de trabajo específica
get-workflow-file : recupera el contenido de un archivo de flujo de trabajo
update-workflow-file : actualiza un archivo de flujo de trabajo con correcciones
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:

Primero, obtenga las ejecuciones de flujo de trabajo fallidas recientes:
I need to check recent failed workflow runs for my repository "username/repo".
Analizar una ejecución fallida específica:
Can you analyze workflow run #123456 and suggest fixes?
Ver el archivo de flujo de trabajo:
Show me the content of the workflow file at .github/workflows/main.yml
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

This server cannot be installed

security - not tested

license - not tested

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Una utilidad que ayuda a diagnosticar y solucionar fallas del flujo de trabajo de GitHub Actions analizando registros de ejecución, identificando patrones de fallas comunes y sugiriendo soluciones específicas a través de un árbol de decisiones estructurado.

Related MCP Servers

mcp-github-project-manager
kunwarVivek
-
security
A
license
-
quality
Provides comprehensive tools for managing GitHub projects, milestones, tasks, and sprints. This server integrates deeply with GitHub Projects V2, offering features like automated kanban workflows, sprint planning, and custom field management.
Last updated -
414
31
TypeScript
MIT License
GitHub MCP Server
asbloom-py
-
security
F
license
-
quality
Enables interaction with GitHub through the GitHub API, supporting file operations, repository management, advanced search, and issue tracking with comprehensive error handling and automatic branch creation.
Last updated -
9
1
TypeScript
GitHub Support Assistant
Jake-Mok-Nelson
A
security
A
license
A
quality
Helps support engineers find similar GitHub issues to speed up troubleshooting by searching repositories and calculating similarity scores based on issue descriptions.
Last updated -
1
TypeScript
MIT License
GitHub Actions MCP Server
ko1ynnky
A
security
F
license
A
quality
An MCP server that enables AI assistants to manage GitHub Actions workflows by providing tools for listing, viewing, triggering, canceling, and rerunning workflows through the GitHub API.
Last updated -
9
52
33
TypeScript

View all related MCP servers

GitHub Workflow Debugger MCP