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

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