Github Action Trigger MCP

🚀 GitHub Action 操作指南

本指南詳細介紹瞭如何使用一系列工具對 GitHub 倉庫進行操作，包括獲取倉庫中的操作、工作流、發佈版本等，以及如何觸發工作流和刪除發佈版本。

🚀 快速開始

工具使用說明

以下是不同操作對應的工具及其使用方法：

1. 獲取倉庫中的操作：使用 get_github_action 工具獲取指定倉庫中的操作。
2. 獲取具體操作的詳細信息：使用 get_github_action_info 工具獲取指定操作的具體信息。
3. 觸發 GitHub 工作流：使用 trigger_github_workflow 工具觸發指定的 GitHub 工作流。
4. 獲取倉庫中的工作流：使用 list_github_workflows 工具獲取指定倉庫中的所有工作流。
5. 獲取倉庫的最新發布版本：使用 get_github_release 工具獲取指定倉庫的最新發布版本。
6. 獲取倉庫的所有發佈版本：使用 list_github_releases 工具獲取指定倉庫的所有發佈版本。
7. 刪除倉庫的發佈版本：使用 delete_github_release 工具刪除指定倉庫的特定發佈版本。

💻 使用示例

1. 獲取倉庫中的操作

請求格式

{
  "owner": "倉庫所有者",
  "repo": "倉庫名稱"
}

示例響應

{
  "count": 2,
  "actions": [
    {
      "name": "構建項目",
      "description": "使用 Node.js 構建項目並生成構建包。",
      "author": "GitHub Actions 團隊",
      "inputs": [
        {
          "名稱": "源代碼分支",
          "描述": "要構建的源代碼分支，默認值: main",
          "是否必填": true
        },
        {
          "名稱": "目標目錄",
          "描述": "構建輸出的目標目錄。",
          "默認值": "dist",
          "是否必填": false
        }
      ],
      "runs": {
        "運行環境": "node16",
        "主文件": "scripts/build.js"
      }
    },
    {
      "name": "運行測試",
      "description": "執行項目中的所有單元測試。",
      "author": "GitHub Actions 團隊",
      "inputs": [
        {
          "名稱": "測試環境",
          "描述": "指定測試環境（開發/生產）。",
          "默認值": "開發",
          "是否必填": false
        }
      ],
      "runs": {
        "運行環境": "node16",
        "主文件": "scripts/test.js"
      }
    }
  ]
}

2. 獲取具體操作的詳細信息

請求格式

{
  "owner": "操作所有者",
  "repo": "操作倉庫名稱",
  "action_id": "操作ID"
}

示例響應

{
  "name": "構建項目",
  "description": "使用 Node.js 構建項目並生成構建包。",
  "author": "GitHub Actions 團隊",
  "inputs": [
    {
      "名稱": "源代碼分支",
      "描述": "要構建的源代碼分支，默認值: main",
      "是否必填": true
    },
    {
      "名稱": "目標目錄",
      "描述": "構建輸出的目標目錄。",
      "默認值": "dist",
      "是否必填": false
    }
  ],
  "runs": {
    "運行環境": "node16",
    "主文件": "scripts/build.js"
  },
  "usage_count": 500,
  "rating": 4.8,
  "review_count": 231
}

3. 觸發 GitHub 工作流

請求格式

{
  "owner": "倉庫所有者",
  "repo": "倉庫名稱",
  "workflow_id": "工作流文件名",
  "inputs": {
    "參數1": "值1",
    "參數2": "值2"
  }
}

示例響應

{
  "success": true,
  "message": "工作流觸發成功。",
  "run": {
    "id": 12345678,
    "url": "https://github.com/owner/repo/actions/runs/12345678",
    "狀態": "排隊中",
    "結論": null,
    "創建時間": "2025-03-19T06:45:12Z",
    "觸發人": "user1"
  }
}

4. 獲取倉庫中的工作流

請求格式

{
  "owner": "倉庫所有者",
  "repo": "倉庫名稱"
}

示例響應

{
  "count": 3,
  "workflows": [
    {
      "name": "每日構建檢查",
      "description": "每天定時運行構建和測試。",
      "creator": "GitHub Actions 團隊",
      "created_at": "2024-01-01T00:00:00Z"
    },
    {
      "name": "合併請求檢查",
      "description": "在每次合併請求時運行檢查。",
      "creator": "開發團隊",
      "created_at": "2024-06-01T00:00:00Z"
    },
    {
      "name": "每週報告生成",
      "description": "每週生成項目報告併發送到Slack頻道。",
      "creator": "數據團隊",
      "created_at": "2024-03-01T00:00:00Z"
    }
  ]
}

5. 獲取倉庫的最新發布版本

請求格式

{
  "owner": "倉庫所有者",
  "repo": "倉庫名稱"
}

示例響應

{
  "tag_name": "v1.0.0",
  "name": "項目發行版1.0.0",
  "body": "## 發行說明\n- 新增功能A\n- 優化性能\n- 修復已知bug",
  "author": "開發團隊",
  "published_at": "2024-10-01T00:00:00Z"
}

6. 獲取倉庫的所有發佈版本

請求格式

{
  "owner": "倉庫所有者",
  "repo": "倉庫名稱"
}

示例響應

{
  "count": 5,
  "releases": [
    {
      "tag_name": "v1.0.0",
      "name": "項目發行版1.0.0",
      "body": "## 發行說明\n- 新增功能A\n- 優化性能\n- 修復已知bug",
      "author": "開發團隊",
      "published_at": "2024-10-01T00:00:00Z"
    },
    {
      "tag_name": "v0.9.0",
      "name": "項目發行版0.9.0",
      "body": "## 發行說明\n- 初始版本發佈",
      "author": "開發團隊",
      "published_at": "2024-09-01T00:00:00Z"
    },
    {
      "tag_name": "v0.8.0",
      "name": "項目發行版0.8.0",
      "body": "## 發行說明\n- 修復一些小問題",
      "author": "開發團隊",
      "published_at": "2024-08-01T00:00:00Z"
    },
    {
      "tag_name": "v0.7.0",
      "name": "項目發行版0.7.0",
      "body": "## 發行說明\n- 增加新功能B",
      "author": "開發團隊",
      "published_at": "2024-07-01T00:00:00Z"
    },
    {
      "tag_name": "v0.6.0",
      "name": "項目發行版0.6.0",
      "body": "## 發行說明\n- 優化代碼結構",
      "author": "開發團隊",
      "published_at": "2024-06-01T00:00:00Z"
    }
  ]
}

7. 刪除倉庫的發佈版本

請求格式

{
  "owner": "倉庫所有者",
  "repo": "倉庫名稱",
  "tag_name": "要刪除的版本號"
}

示例響應

{
  "message": "刪除成功",
  "deleted_tag": "v0.6.0"
}

⚠️ 注意事項

⚠️ 重要提示

1. 權限要求：執行這些操作需要有相應的權限。例如，刪除發佈版本可能需要更高的權限。
2. API限制：某些操作可能會受到API速率限制的影響，具體取決於GitHub的設置和您的計劃（如免費層、Pro層等）。
3. 驗證信息：確保您提供的身份驗證信息（如token）是有效的，並且具有執行相應操作的權限。