GitHub Actions

GitHub Actions

A Model Context Protocol (MCP) server for interacting with GitHub Actions.

40
Stars
17
Forks
0
Releases

Overview

The GitHub Actions MCP Server provides a dedicated MCP interface to interact with the GitHub Actions API. It enables AI assistants to list, view, trigger, cancel, and rerun workflows, and to analyze workflow runs and their jobs. The server exposes a defined set of tools, including 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 with specified inputs and return values. It emphasizes robust type validation to handle API variations, clear and enhanced error messages, and security-focused design featuring timeout handling, rate limiting, and strict URL validation. The MCP server is compatible with multiple AI coding assistants such as Claude Desktop, Codeium, and Windsurf, facilitating integration into AI-assisted workflows. Build instructions cover Unix-like and Windows environments, with commands to install, build, and start, and sample usage demonstrates listing workflows or triggering a workflow. The project is available as a practical example and will be archived as official GitHub Actions support matures, but remains useful for exploring MCP server design for GitHub Actions.

Details

Owner
ko1ynnky
Language
TypeScript
License
Updated
2025-12-07

Features

Complete Workflow Management

List, view, trigger, cancel, and rerun workflows.

Workflow Run Analysis

Get detailed information about workflow runs and their jobs.

Comprehensive Error Handling

Clear error messages with enhanced details.

Flexible Type Validation

Robust type checking with graceful handling of API variations.

Security-Focused Design

Timeout handling, rate limiting, and strict URL validation.

Audience

AI coding assistantsInteract with GitHub Actions via MCP to manage workflows, runs, and data.
Developers integrating MCP server with GitHub ActionsBuild AI-enabled automation tools that trigger and monitor workflows.
GitHub Actions users exploring AI-assisted managementLeverage MCP server to list workflows, fetch run details, and trigger workflows.

Tags

GitHub ActionsMCPworkflow managementworkflow runsAPI integrationAI assistantssecurityrate limitingtype validationerror handling