Github Action Trigger MCP

🚀 GitHub Action Operation Guide

This guide provides a detailed introduction to using various tools to interact with GitHub Actions, including retrieving actions, workflows, and release information, as well as triggering workflows and deleting releases.

🚀 Quick Start

🔍 1. Get Actions in a Repository

Use the get_github_action tool to obtain actions in a specified repository.

Request Format

{
  "owner": "Repository Owner",
  "repo": "Repository Name"
}

Example Response

{
  "count": 2,
  "actions": [
    {
      "name": "Build Project",
      "description": "Build the project using Node.js and generate a build package.",
      "author": "GitHub Actions Team",
      "inputs": [
        {
          "name": "Source Code Branch",
          "description": "The source code branch to build. Default: main",
          "required": true
        },
        {
          "name": "Target Directory",
          "description": "The target directory for the build output.",
          "default": "dist",
          "required": false
        }
      ],
      "runs": {
        "environment": "node16",
        "main_file": "scripts/build.js"
      }
    },
    {
      "name": "Run Tests",
      "description": "Execute all unit tests in the project.",
      "author": "GitHub Actions Team",
      "inputs": [
        {
          "name": "Test Environment",
          "description": "Specify the test environment (Development/Production).",
          "default": "Development",
          "required": false
        }
      ],
      "runs": {
        "environment": "node16",
        "main_file": "scripts/test.js"
      }
    }
  ]
}

🔍 2. Get Detailed Information of a Specific Action

Use the get_github_action_info tool to obtain detailed information about a specified action.

Request Format

{
  "owner": "Action Owner",
  "repo": "Action Repository Name",
  "action_id": "Action ID"
}

Example Response

{
  "name": "Build Project",
  "description": "Build the project using Node.js and generate a build package.",
  "author": "GitHub Actions Team",
  "inputs": [
    {
      "name": "Source Code Branch",
      "description": "The source code branch to build. Default: main",
      "required": true
    },
    {
      "name": "Target Directory",
      "description": "The target directory for the build output.",
      "default": "dist",
      "required": false
    }
  ],
  "runs": {
    "environment": "node16",
    "main_file": "scripts/build.js"
  },
  "usage_count": 500,
  "rating": 4.8,
  "review_count": 231
}

🔍 3. Trigger a GitHub Workflow

Use the trigger_github_workflow tool to trigger a specified GitHub workflow.

Request Format

{
  "owner": "Repository Owner",
  "repo": "Repository Name",
  "workflow_id": "Workflow File Name",
  "inputs": {
    "Parameter 1": "Value 1",
    "Parameter 2": "Value 2"
  }
}

Example Response

{
  "success": true,
  "message": "Workflow triggered successfully.",
  "run": {
    "id": 12345678,
    "url": "https://github.com/owner/repo/actions/runs/12345678",
    "status": "Queued",
    "conclusion": null,
    "created_at": "2025-03-19T06:45:12Z",
    "triggered_by": "user1"
  }
}

🔍 4. Get Workflows in a Repository

Use the list_github_workflows tool to obtain all workflows in a specified repository.

Request Format

{
  "owner": "Repository Owner",
  "repo": "Repository Name"
}

Example Response

{
  "count": 3,
  "workflows": [
    {
      "name": "Daily Build Check",
      "description": "Run builds and tests regularly every day.",
      "creator": "GitHub Actions Team",
      "created_at": "2024-01-01T00:00:00Z"
    },
    {
      "name": "Pull Request Check",
      "description": "Run checks on every pull request.",
      "creator": "Development Team",
      "created_at": "2024-06-01T00:00:00Z"
    },
    {
      "name": "Weekly Report Generation",
      "description": "Generate a project report weekly and send it to the Slack channel.",
      "creator": "Data Team",
      "created_at": "2024-03-01T00:00:00Z"
    }
  ]
}

🔍 5. Get the Latest Release of a Repository

Use the get_github_release tool to obtain the latest release of a specified repository.

Request Format

{
  "owner": "Repository Owner",
  "repo": "Repository Name"
}

Example Response

{
  "tag_name": "v1.0.0",
  "name": "Project Release 1.0.0",
  "body": "## Release Notes\n- New Feature A\n- Performance Optimization\n- Bug Fixes",
  "author": "Development Team",
  "published_at": "2024-10-01T00:00:00Z"
}

🔍 6. Get All Releases of a Repository

Use the list_github_releases tool to obtain all releases of a specified repository.

Request Format

{
  "owner": "Repository Owner",
  "repo": "Repository Name"
}

Example Response

{
  "count": 5,
  "releases": [
    {
      "tag_name": "v1.0.0",
      "name": "Project Release 1.0.0",
      "body": "## Release Notes\n- New Feature A\n- Performance Optimization\n- Bug Fixes",
      "author": "Development Team",
      "published_at": "2024-10-01T00:00:00Z"
    },
    {
      "tag_name": "v0.9.0",
      "name": "Project Release 0.9.0",
      "body": "## Release Notes\n- Initial Release",
      "author": "Development Team",
      "published_at": "2024-09-01T00:00:00Z"
    },
    {
      "tag_name": "v0.8.0",
      "name": "Project Release 0.8.0",
      "body": "## Release Notes\n- Minor Bug Fixes",
      "author": "Development Team",
      "published_at": "2024-08-01T00:00:00Z"
    },
    {
      "tag_name": "v0.7.0",
      "name": "Project Release 0.7.0",
      "body": "## Release Notes\n- New Feature B",
      "author": "Development Team",
      "published_at": "2024-07-01T00:00:00Z"
    },
    {
      "tag_name": "v0.6.0",
      "name": "Project Release 0.6.0",
      "body": "## Release Notes\n- Code Structure Optimization",
      "author": "Development Team",
      "published_at": "2024-06-01T00:00:00Z"
    }
  ]
}

🔍 7. Delete a Release of a Repository

Use the delete_github_release tool to delete a specific release of a specified repository.

Request Format

{
  "owner": "Repository Owner",
  "repo": "Repository Name",
  "tag_name": "Release Version to Delete"
}

Example Response

{
  "message": "Deletion successful",
  "deleted_tag": "v0.6.0"
}

⚠️ Important Note

• Permission Requirements: You need appropriate permissions to perform these operations. For example, deleting a release may require higher-level permissions.
• API Limits: Some operations may be affected by API rate limits, depending on GitHub's settings and your plan (e.g., Free, Pro, etc.).
• Authentication: Ensure that the authentication information (e.g., token) you provide is valid and has the necessary permissions to perform the corresponding operations.