nextdriveioe_github_action_trigger_mcp

nextdriveioe_github_action_trigger_mcp

by nextDriveIoE
A TypeScript-based MCP server for integrating and managing GitHub Actions within repositories.

GitHub Action Trigger MCP Server

A TypeScript-based Model Context Protocol (MCP) server designed for GitHub Actions integration.

Overview

This server provides tools for interacting with GitHub Actions, including fetching available actions, retrieving detailed action information, triggering workflow dispatches, and fetching repository releases.

Features

Tools

  • get_github_actions: Fetches available GitHub Actions for a repository.
  • Required Parameters: owner, repo
  • Optional Parameters: token

  • Returns: JSON data with workflow details.

  • get_github_action: Retrieves detailed information about a specific GitHub Action.

  • Required Parameters: owner, repo
  • Optional Parameters: path, ref, token

  • Returns: Detailed action information.

  • trigger_github_action: Triggers a GitHub workflow.

  • Required Parameters: owner, repo, workflow_id
  • Optional Parameters: ref, inputs, token

  • Returns: Workflow run information.

  • get_github_release: Fetches the latest 2 releases from a GitHub repository.

  • Required Parameters: owner, repo
  • Optional Parameters: token
  • Returns: Release information.

Installation

Recommended Installation: Using npx

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

Local Installation

  1. Install the package:
npm install -g @nextdrive/github-action-trigger-mcp
  1. Configure in Claude Desktop:
{
  "mcpServers": {
    "github-action-trigger-mcp": {
      "command": "@nextdrive/github-action-trigger-mcp",
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_token_here"
      }
    }
  }
}

GitHub Token Configuration

Method 1: Direct Configuration in Claude Desktop

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

Method 2: Global Environment Variable

export GITHUB_TOKEN=your_github_token

Method 3: Local Configuration File

Edit ~/.nextdrive-github-action-trigger-mcp/config.json:

{
  "githubToken": "your_github_token"
}

Development

Install Dependencies

npm install

Build the Server

npm run build

Debugging

npm run inspector

Publishing to npm

  1. Log in to npm:
npm login
  1. Build the project:
npm run build
  1. Publish:
npm publish --access public

Usage Examples

Getting a List of GitHub Actions

{
  "owner": "username-or-org",
  "repo": "repository-name"
}

Getting Detailed GitHub Action Information

{
  "owner": "actions",
  "repo": "checkout",
  "ref": "v4"
}

Triggering a GitHub Workflow

{
  "owner": "username-or-org",
  "repo": "repository-name",
  "workflow_id": "ci.yml",
  "inputs": {
    "deploy_environment": "production",
    "debug_enabled": "true"
  }
}

Getting Latest Releases

{
  "owner": "username-or-org",
  "repo": "repository-name"
}

About

No description, website, or topics provided.

Features & Capabilities

Categories
mcp_server model_context_protocol typescript github_actions api_integration workflow_automation

Implementation Details

View on GitHub

Stats

0 Views
1 GitHub Stars

Repository Info

nextDriveIoE Organization

Similar MCP Servers

continuedev_continue by continuedev
25049
cherryhq_cherry_studio by CherryHQ
21423
bytedance_ui_tars_desktop by bytedance
9300
2025© BestAI