A
security-
licenseA
qualityAn 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
7
39
Enables fetching and analyzing GitHub repository information and workflow files through the GitHub API
Provides tools for diagnosing and fixing GitHub Actions workflow failures, including fetching failed runs, analyzing job logs, and suggesting fixes for common issues
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 repositoriesworkflow- 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
get-failed-workflow-runs - Fetches recent failed workflow runs for a repository
get-workflow-run-jobs - Gets jobs for a specific workflow run
get-workflow-file - Retrieves the content of a workflow file
update-workflow-file - Updates a workflow file with fixes
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:
First, get recent failed workflow runs:
I need to check recent failed workflow runs for my repository "username/repo".Analyze a specific failed run:
Can you analyze workflow run #123456 and suggest fixes?View the workflow file:
Show me the content of the workflow file at .github/workflows/main.ymlUpdate 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 serverbuild/- Compiled JavaScript files
License
ISC
This server cannot be installed
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.
A utility that helps diagnose and fix GitHub Actions workflow failures by analyzing run logs, identifying common failure patterns, and suggesting specific fixes through a structured decision tree.
Related MCP Servers
- Asecurity-licenseAqualityEnables comprehensive GitHub operations through natural language including file management, repository administration, issue tracking, and advanced code searching.Last updated -4711
- -security-license-qualityA set of tools allowing AI assistants to interact directly with GitHub, enabling automation of tasks like fetching user profiles, creating repositories, and managing pull requests.Last updated -
- Asecurity-licenseAqualityGitHub Actions Model Context Protocol Server that allows you to create, manage, monitor, and interact with workflows.Last updated -10