https://github.com/lailo/github-actions-mcp
MCP server for analyzing GitHub Actions workflows and performance
https://github.com/lailo/github-actions-mcp
ai-agents bun eslint lefthook mcp-server prettier typescript
Last synced: 5 months ago
JSON representation
MCP server for analyzing GitHub Actions workflows and performance
- Host: GitHub
- URL: https://github.com/lailo/github-actions-mcp
- Owner: lailo
- Created: 2025-07-27T16:09:15.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-08-25T17:18:10.000Z (10 months ago)
- Last Synced: 2025-09-01T01:23:56.461Z (10 months ago)
- Topics: ai-agents, bun, eslint, lefthook, mcp-server, prettier, typescript
- Language: TypeScript
- Homepage:
- Size: 381 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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:
```bash
bun install
```
3. Set up your GitHub token:
```bash
cp .env.example .env
# Edit .env and add your GitHub token
```
4. Build the project:
```bash
bun run build
```
## Usage
### Running the MCP Server
```bash
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:
```bash
# 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:
```json
{
"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](https://github.com/settings/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