GitHub Actions MCP Server

An MCP (Model Context Protocol) server for analyzing GitHub Actions workflows and performance. This tool helps identify bottlenecks, failures, and optimization opportunities in your CI/CD pipelines.

Features

• Workflow Discovery: List all workflows in a repository

• Run Analysis: Get detailed information about workflow runs with filtering

• Performance Analysis: Analyze workflow runs to identify slow jobs and failures

• Timing Details: Get detailed timing information for jobs and steps

Related MCP server: GitHub Actions MCP

Installation

1. Clone this repository

2. Install dependencies:

   bun install

3. Set up your GitHub token:

   cp .env.example .env
   # Edit .env and add your GitHub token

4. Build the project:

   bun run build

Usage

Running the MCP Server

bun run start

The server communicates via stdio and can be integrated with MCP-compatible clients.

Development

The MCP Inspector provides a web-based interface to test your server:

# First, install dependencies
bun install

bun run dev

This will open a web interface where you can:

• View available tools

• Test tool calls interactively

• See request/response data

• Debug tool schemas

Using with Claude Desktop

To use this MCP server with Claude Desktop, add the following configuration to your Claude Desktop settings:

{
  "mcpServers": {
    "github-actions": {
      "command": "bun",
      "args": ["run", "start"],
      "cwd": "/path/to/your/github-actions-mcp",
      "env": {
        "GITHUB_TOKEN": "your_github_token_here"
      }
    }
  }
}

Important Notes:

• Replace /path/to/your/github-actions-mcp with the actual path to your project directory

• Replace your_github_token_here with your actual GitHub personal access token

• Make sure Bun is installed and available in your system PATH

• Restart Claude Desktop after making configuration changes

After configuration, Claude Desktop will automatically connect to your MCP server and you'll be able to use commands like:

• "List workflows in my repository owner/repo-name"

• "Analyze the latest failed workflow run for owner/repo-name"

• "Show me timing details for workflow run 123456"

GitHub Token Setup

1. Go to GitHub Settings > Developer settings > Personal access tokens

2. Generate a new token with the following permissions:

   • repo (Full control of private repositories)

   • actions:read (Read access to actions and workflows)

3. Add the token to your .env file