Github Action Trigger Mcp

by nextDriveIoE

382 downloads
Not rated
GitHub

Description

# GitHub Action Trigger MCP Server A Model Context Protocol server for GitHub Actions integration. ## Overview This is a TypeScript-based MCP server designed for GitHub Actions integration. It provides the following features: - Tool for fetching available GitHub Actions from a…

About

# GitHub Action Trigger MCP Server A Model Context Protocol server for GitHub Actions integration. ## Overview This is a TypeScript-based MCP server designed for GitHub Actions integration. It provides the following features: - Tool for fetching available GitHub Actions from a repository - Tool for getting detailed…

Details

Author
nextDriveIoE
Downloads
382
Categories
Developer Tools

- get_github_actions: list workflows in a repository
- get_github_action: get detailed action metadata and inputs
- trigger_github_action: trigger a workflow_dispatch event
- get_github_release: fetch the latest 2 releases

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Github Action Trigger Mcp
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via npx (recommended) or npm install -g @nextdrive/github-action-trigger-mcp, then add the server to your Claude Desktop configuration with a GitHub personal access token. Use the four provided tools with owner, repo, and optional parameters.

get_github_actions

Get available GitHub Actions for a repository

get_github_action

Get detailed information about a specific GitHub Action, including inputs and their requirements

trigger_github_action

Trigger a GitHub workflow dispatch event with custom inputs

get_github_release

Get the latest 2 releases from a GitHub repository

enable_pull_request_automerge

Enable auto-merge for a specific pull request. This will automatically merge the PR when all required checks pass.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "github action trigger mcp": {
            "github-action-trigger-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@nextdrive/github-action-trigger-mcp"
                ],
                "env": {
                    "GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_token_here"
                }
            }
        }
    }
}

McpServers

{
    "github-action-trigger-mcp": {
        "command": "npx",
        "args": [
            "-y",
            "@nextdrive/github-action-trigger-mcp"
        ],
        "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_token_here"
        }
    }
}

GitHub Action Trigger MCP Server

A Model Context Protocol server for GitHub Actions integration.

Overview

This is a TypeScript-based MCP server designed for GitHub Actions integration. It provides the following features:

- Tool for fetching available GitHub Actions from a repository
- Tool for getting detailed information about a specific GitHub Action
- Tool for triggering GitHub workflow dispatch events
- Tool for fetching the latest releases from a GitHub repository

Features

Tools

- get_github_actions - Get available GitHub Actions for a repository
- Required parameters: owner (repository owner, username or organization) and repo (repository name)
- Optional parameters: token (GitHub personal access token, for accessing private repositories or increasing API rate limits)
- Returns JSON data with workflow ID, name, path, state, URL, and content

- get_github_action - Get detailed information about a specific GitHub Action, including inputs and their requirements
- Required parameters: owner (Action owner, username or organization) and repo (repository name of the action)
- Optional parameters:
- path: Path to the action definition file (default: 'action.yml')
- ref: Git reference (branch, tag, or commit SHA, default: 'main')
- token: GitHub personal access token (optional)
- Returns detailed information about the Action, including name, description, author, inputs (and whether they're required), etc.

- trigger_github_action - Trigger a GitHub workflow and pass relevant parameters
- Required parameters:
- owner: Repository owner (username or organization)
- repo: Repository name
- workflow_id: The ID or filename of the workflow to trigger
- Optional parameters:
- ref: The git reference to trigger the workflow on (default: 'main')
- inputs: Inputs to pass to the workflow (must match the workflow's defined inputs)
- token: GitHub personal access token (must have the workflow scope)
- Returns workflow run information, including status, URL, etc.

- get_github_release - Get the latest 2 releases from a GitHub repository
- Required parameters: owner (repository owner, username or organization) and repo (repository name)
- Optional parameters: token (GitHub personal access token, optional)
- Returns information about the latest 2 releases

Installation

Recommended Installation: Using npx

The simplest way to install and use is via the npx command in your Claude Desktop configuration file without manual local installation:

{
  "mcpServers": {
    "github-action-trigger-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@nextdrive/github-action-trigger-mcp"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_token_here"
      }
    }
  }
}

Benefits of this method:
- No local package installation required
- Automatically uses the latest version
- Set up once and ready to use
- Built-in GitHub token configuration

Local Installation

If you prefer to install manually, follow these steps:

1. Install the package:

npm install -g @nextdrive/github-action-trigger-mcp

2. Use in Claude Desktop configuration:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "github-action-trigger-mcp": {
      "command": "@nextdrive/github-action-trigger-mcp",
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_token_here"
      }
    }
  }
}

GitHub Token Configuration

To access the GitHub API, especially for private repositories or workflow triggers, you need to configure a GitHub personal access token. There are several ways to do this:

Method 1 (Recommended): Direct Configuration in Claude Desktop

Set the token directly in the Claude Desktop configuration file via the env field:

"env": {
  "GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_token_here"
}

Method 2: Global Environment Variable

Set the GITHUB_TOKEN environment variable:

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.