Related MCP Server Resources

Explore more AI models, providers, and integration options:

  • Explore AI Models
  • Explore AI Providers
  • Explore MCP Servers
  • LangDB Pricing
  • Documentation
  • AI Industry Blog
  • GitHub Repository MCP Server
  • GitHub PR Comments MCP Server
  • GitHub MCP Server
  • MCP GitHub Issue Server
  • GHAS MCP server GitHub Advanced Security
Back to MCP Servers
GitHub Workflow Debugger MCP

GitHub Workflow Debugger MCP

Public
Maxteabag/GithubWorkflowMCP

Diagnose and fix GitHub Actions workflow failures using the GitHub API with tools to fetch failed runs, analyze jobs, identify issues, suggest fixes, and update workflow files via Model Context Protocol integration.

typescript
0 tools
May 30, 2025
Updated Jun 4, 2025

Supercharge Your AI with GitHub Workflow Debugger MCP

MCP Server

Unlock the full potential of GitHub Workflow Debugger MCP through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.

Unified API Access
Complete Tracing
Instant Setup
Get Started Now

Free tier available • No credit card required

Instant Setup
99.9% Uptime
10,000+Monthly Requests

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": "" } } } }

Replace `` 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

Publicly Shared Threads0

Discover shared experiences

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!

Share your threads to help others
Related MCPs5
  • GitHub Repository MCP Server
    GitHub Repository MCP Server

    Enables AI models to access GitHub repository contents via Model Context Protocol, offering tools to...

    3 tools
    Added May 30, 2025
  • GitHub PR Comments MCP Server
    GitHub PR Comments MCP Server

    Fetch GitHub Pull Request comments with detailed file paths, line ranges, and threaded replies via a...

    Added May 30, 2025
  • GitHub MCP Server
    GitHub MCP Server

    Enhance Claude Desktop with seamless GitHub integration via Model Context Protocol, enabling natural...

    Added May 30, 2025
  • MCP GitHub Issue Server
    MCP GitHub Issue Server

    Enables LLMs to fetch and utilize GitHub issue details from public repositories as structured task d...

    1 tools
    Added May 30, 2025
  • GHAS MCP server GitHub Advanced Security
    GHAS MCP server GitHub Advanced Security

    Provides Model Context Protocol (MCP) integration for GitHub Advanced Security by enabling read-only...

    Added May 30, 2025