GitHub Actions MCP Server

Overview

GitHub Actions MCP Server enables AI assistants to manage and operate GitHub Actions workflows through a standardized interface. This server bridges the gap between AI coding assistants and GitHub's CI/CD platform, allowing for seamless workflow automation and management.

Installation

Prerequisites

• Node.js (v14 or higher)
• A GitHub Personal Access Token with appropriate permissions for Actions
• An AI assistant that supports MCP (Claude Desktop, Codeium, Windsurf, etc.)

Setup Instructions

1. Clone the repository:

   git clone https://github.com/ko1ynnky/github-actions-mcp-server.git
   cd github-actions-mcp-server
   

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

4. Configure your GitHub Personal Access Token:

   You'll need to create a GitHub Personal Access Token with the appropriate permissions for GitHub Actions. The token should have at minimum the workflow scope.

Integration with AI Assistants

Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "github-actions": {
      "command": "node",
      "args": [
        "/path/to/github-actions-mcp-server/dist/index.js"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_TOKEN"
      }
    }
  }
}

Codeium

Add the following to your Codeium MCP configuration file:

{
  "github-actions": {
    "command": "node",
    "args": [
      "/path/to/github-actions-mcp-server/dist/index.js"
    ],
    "env": {
      "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_TOKEN"
    }
  }
}

Windsurf

Configure the server in your Windsurf settings:

{
  "mcpServers": {
    "github-actions": {
      "command": "node",
      "args": [
        "/path/to/github-actions-mcp-server/dist/index.js"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_TOKEN"
      }
    }
  }
}

Docker Support

The server can also be run as a Docker container:

1. Build the Docker image:

   docker build -t github-actions-mcp-server .
   

2. Run the container:

   docker run -e GITHUB_PERSONAL_ACCESS_TOKEN=YOUR_GITHUB_TOKEN github-actions-mcp-server
   

Usage Examples

Once configured, you can ask your AI assistant to perform GitHub Actions operations. Here are some example prompts:

• "List all workflows in the repository username/repo-name"
• "Trigger the CI workflow on the main branch of username/repo-name"
• "Show me the details of workflow run #12345"
• "Cancel the currently running workflow with ID 67890"
• "Rerun the failed workflow from yesterday"

Troubleshooting

If you encounter issues:

1. Check your GitHub token: Ensure it has the correct permissions and hasn't expired
2. Verify network connectivity: The server needs to communicate with GitHub's API
3. Check logs: Look for error messages in the server output
4. Rate limiting: GitHub API has rate limits that may affect usage

For Windows users, use the provided run-server.bat script for easier execution.