Github Action Trigger MCP

🚀 GitHub Action 操作ガイド

このドキュメントは、GitHub Actionに関する操作方法を説明しています。以下の各ツールを使用して、GitHubのリポジトリやアクションに関する情報を取得し、操作を実行することができます。

🚀 クイックスタート

1. リポジトリ内のアクションを取得する

get_github_action ツールを使用して、指定されたリポジトリ内のアクションを取得します。

リクエスト形式

{
  "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. 特定のアクションの詳細情報を取得する

get_github_action_info ツールを使用して、指定されたアクションの詳細情報を取得します。

リクエスト形式

{
  "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ワークフローをトリガーする

trigger_github_workflow ツールを使用して、指定された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. リポジトリ内のワークフローを取得する

list_github_workflows ツールを使用して、指定されたリポジトリ内のすべてのワークフローを取得します。

リクエスト形式

{
  "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. リポジトリの最新リリースバージョンを取得する

get_github_release ツールを使用して、指定されたリポジトリの最新リリースバージョンを取得します。

リクエスト形式

{
  "owner": "リポジトリの所有者",
  "repo": "リポジトリ名"
}

応答例

{
  "tag_name": "v1.0.0",
  "name": "プロジェクトリリース版1.0.0",
  "body": "## リリースノート\n- 新機能Aの追加\n- パフォーマンスの最適化\n- 既知のバグの修正",
  "author": "開発チーム",
  "published_at": "2024-10-01T00:00:00Z"
}

6. リポジトリのすべてのリリースバージョンを取得する

list_github_releases ツールを使用して、指定されたリポジトリのすべてのリリースバージョンを取得します。

リクエスト形式

{
  "owner": "リポジトリの所有者",
  "repo": "リポジトリ名"
}

応答例

{
  "count": 5,
  "releases": [
    {
      "tag_name": "v1.0.0",
      "name": "プロジェクトリリース版1.0.0",
      "body": "## リリースノート\n- 新機能Aの追加\n- パフォーマンスの最適化\n- 既知のバグの修正",
      "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. リポジトリのリリースバージョンを削除する

delete_github_release ツールを使用して、指定されたリポジトリの特定のリリースバージョンを削除します。

リクエスト形式

{
  "owner": "リポジトリの所有者",
  "repo": "リポジトリ名",
  "tag_name": "削除するバージョン番号"
}

応答例

{
  "message": "削除に成功しました",
  "deleted_tag": "v0.6.0"
}

⚠️ 重要な注意事項

• 権限の要件：これらの操作を実行するには、適切な権限が必要です。例えば、リリースバージョンの削除には、より高い権限が必要な場合があります。
• APIの制限：一部の操作は、GitHubの設定やあなたのプラン（無料版、Pro版など）によって、APIのレート制限の影響を受ける場合があります。
• 認証情報の検証：提供する認証情報（トークンなど）が有効であり、対応する操作を実行する権限があることを確認してください。