What is Githubworkflowmcp

GithubWorkflowMCP is a Multi-Choice Prompt (MCP) utility designed to diagnose and fix GitHub Actions workflow failures using the GitHub API. It employs a structured decision tree to assist users in identifying and resolving issues within their workflows.

Use cases

Use cases for GithubWorkflowMCP include troubleshooting failed GitHub Actions, optimizing workflow configurations, and providing automated suggestions for fixing common issues in CI/CD pipelines.

How to use

To use GithubWorkflowMCP, install it via Smithery or manually by cloning the repository and installing dependencies. Ensure you have a GitHub Personal Access Token with the necessary permissions and set it as an environment variable. The tool can then be utilized with AI assistants that support MCP.

Key features

Key features include fetching recent failed workflow runs, analyzing workflow jobs and steps, identifying common failure patterns, suggesting specific fixes for issues, and allowing users to view and update workflow files.

Where to use

GithubWorkflowMCP is primarily used in software development environments where GitHub Actions are employed for CI/CD processes. It is beneficial for developers and teams managing complex workflows.

GitHub Workflow Debugger MCP

A Multi-Choice Prompt (MCP) utility for diagnosing and fixing GitHub Actions workflow failures using the GitHub API.

Overview

This tool helps users diagnose and fix GitHub Actions workflow failures through a structured decision tree. It uses the GitHub API to fetch workflow run information, analyze failures, and provide actionable solutions.

Features

• Fetch recent failed workflow runs for a repository
• Analyze workflow run jobs and steps
• Identify common failure patterns
• Suggest specific fixes for common issues
• View and update workflow files

Installation

Installing via Smithery

To install githubworkflowmcp for Claude Desktop automatically via Smithery:

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

Manual Installation

# 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

Usage

The GitHub Workflow Debugger MCP is designed to be used with AI assistants that support the Model Context Protocol (MCP). It provides several tools that can be used to diagnose and fix GitHub Actions workflow failures.

Required Permissions

To use this tool, you’ll need a GitHub Personal Access Token (PAT) with the following permissions:

• repo - Full control of private repositories
• workflow - Update GitHub Action workflows

You must set this token as an environment variable named GITHUB_PERSONAL_ACCESS_TOKEN.

Configuration

When using this tool with an MCP-compatible client, you can configure it as follows:

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

Replace <YOUR_TOKEN> with your GitHub Personal Access Token.

Available Tools

1. get-failed-workflow-runs - Fetches recent failed workflow runs for a repository
2. get-workflow-run-jobs - Gets jobs for a specific workflow run
3. get-workflow-file - Retrieves the content of a workflow file
4. update-workflow-file - Updates a workflow file with fixes
5. analyze-workflow-failure - Analyzes a failed workflow run and suggests fixes

Example Usage

Here’s an example of how to use the GitHub Workflow Debugger MCP with an AI assistant:

1. First, get recent failed workflow runs:

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

2. Analyze a specific failed run:

   Can you analyze workflow run #123456 and suggest fixes?
   

3. View the workflow file:

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

4. Update the workflow file with fixes:

   Update the workflow file with the suggested fixes.
   

Development

Prerequisites

• Node.js 16 or higher
• npm or yarn

Setup

# Install dependencies
npm install

# Build the project
npm run build

Project Structure

• src/index.ts - Main entry point for the MCP server
• build/ - Compiled JavaScript files

License

ISC