GitHub Actions MCP Server

This MCP Server facilitates AI assistants in managing GitHub Actions workflows through the GitHub Actions API.

Features

• Workflow Management: Enables listing, viewing, triggering, canceling, and re-running workflows.
• Workflow Run Analysis: Provides detailed information about workflow runs and their jobs.
• Error Handling: Delivers clear error messages with enhanced details.
• Type Validation: Implements robust type checking to handle API variations.
• Security: Includes timeout handling, rate limiting, and strict URL validation.

Tools

The server offers tools like list_workflows, get_workflow, get_workflow_usage, list_workflow_runs, get_workflow_run, get_workflow_run_jobs, trigger_workflow, cancel_workflow_run, and rerun_workflow. Each tool accepts specific inputs (owner, repo, workflowId, etc.) and returns relevant data.

Usage with Claude Desktop

Configuration involves adding a github-actions entry to claude_desktop_config.json, specifying the command, arguments (path to dist/index.js), and setting the GITHUB_PERSONAL_ACCESS_TOKEN environment variable.

Build

Clone the repository, navigate into it, run npm install and npm run build to create the necessary files in the dist directory.

Troubleshooting

Addresses common issues like authentication errors, rate limiting, and type validation errors.