Mcp Server Github Actions

mcp-server-github-actions

AI アシスタントから GitHub Actions ワークフローを管理できます。実行状況の一覧表示やログの確認、失敗したジョブの再実行、ビルドのキャンセル、デプロイの開始を、エディターを離れずに行えます。

npx mcp-server-github-actions

Claude Desktop、Cursor、VS Code Copilot、その他あらゆる MCP クライアントで利用できます。Actions 権限を持つ GitHub トークンが必要です。

_{remotion-readme-kitで作成したデモ}

このプロジェクトの理由

GitHub 公式の MCP サーバーはリポジトリ、イシュー、PR に対応していますが、Actions には対応していません。そのため CI が失敗した場合、今でもブラウザーを開いて実行を探し、ログを開き、何が問題だったのかを調べる必要があります。このサーバーはそのギャップを埋めます。「直近の CI 実行が失敗した理由は？」「失敗したジョブを再実行して」とアシスタントに尋ねれば、作業中の場所で回答を得られます。手動で使う GitHub REST API と同じものを使い、作業を切り替える手間だけを省きます。

ツール

ツール	説明
list_workflows	リポジトリ内のすべてのワークフローファイルを一覧表示します
list_runs	ワークフローの実行を一覧表示します（ワークフローまたはステータスで絞り込み可能）
get_run	特定のワークフロー実行の詳細を取得します
get_run_logs	実行のログ URL を取得します（zip ファイルのダウンロード）
rerun_workflow	ワークフローの実行全体を再実行します
rerun_failed_jobs	実行内の失敗したジョブのみを再実行します
cancel_run	実行中またはキューに入っている実行をキャンセルします
list_artifacts	ワークフロー実行で生成されたアーティファクトを一覧表示します
trigger_workflow	workflow_dispatch 経由でワークフローを開始します

クイックスタート

Cursor

Cursor の MCP 設定（例：~/.cursor/mcp.json またはプロジェクトレベルの設定）に追加します。

{
  "mcpServers": {
    "github-actions": {
      "command": "npx",
      "args": ["-y", "mcp-server-github-actions"],
      "env": {
        "GITHUB_TOKEN": "<your-token>"
      }
    }
  }
}

Claude Desktop

claude_desktop_config.jsonに追加します。

{
  "mcpServers": {
    "github-actions": {
      "command": "npx",
      "args": ["-y", "mcp-server-github-actions"],
      "env": {
        "GITHUB_TOKEN": "<your-token>"
      }
    }
  }
}

VS Code

ユーザー設定または.vscode/mcp.jsonに追加します。

{
  "mcp": {
    "servers": {
      "github-actions": {
        "command": "npx",
        "args": ["-y", "mcp-server-github-actions"],
        "env": {
          "GITHUB_TOKEN": "<your-token>"
        }
      }
    }
  }
}

認証

GitHub Personal Access Token を作成します。

1. Settings > Developer settings > Personal access tokens
2. Fine-grained tokens（推奨）または Tokens (classic) を選択します
3. Fine-grained の場合：リポジトリを選択し、Actions: Read and Writeを有効にします
4. Classic の場合：repoスコープを有効にします（Actions 権限を含みます）

Agent Plugins

このリポジトリはAgent Plugins 1.0.0 パッケージです。plugin.json、ポータブルなmcp.json、skills/が MCP サーバーとともに提供されます。

Cursor では、リポジトリをクローンし、~/.cursor/plugins/local/mcp-server-github-actionsにコピーまたはシンボリックリンクを作成してから、ウィンドウを再読み込みします。Skills と MCP は Customize > Plugins に表示されます。

Agent Plugins v1 では OAuth は提供されません。MCP クライアントの設定でGITHUB_TOKENを設定してください（クイックスタートを参照）。トークンを環境変数に保持する必要があるため、Cursor／VS Code のワンクリックインストールは提供されていません。

FAQ

mcp-server-github-actions とは？

GitHub Actions 用の MCP サーバーです。実行履歴の一覧表示、実行詳細の取得、失敗したジョブの再実行、実行のキャンセル、アーティファクトの一覧表示、workflow_dispatch のトリガーができます。

どのトークンが必要ですか？

管理するリポジトリで Actions の読み取り／書き込み権限を持つ GitHub PAT が必要です。MCP サーバーの環境変数ブロックで GITHUB_TOKEN を設定してください。

公式の GitHub MCP との違いは何ですか？

公式サーバーはリポジトリ、イシュー、PR をカバーします。こちらはワークフローの実行、ログ URL、再実行、ディスパッチのトリガーに特化しています。

Cursor のエージェントプラグインとしてインストールできますか？

はい。~/.cursor/plugins/local/mcp-server-github-actions を使用します。Cursor の MCP 設定でも引き続き GITHUB_TOKEN を設定する必要があります。

ワンクリックインストールボタンがないのはなぜですか？

トークンをポータブルなインストールリンクに安全に埋め込むことができないためです。クイックスタートの下にある JSON スニペットを使用してください。

プロンプトの例

• 「ofershap/mcp-server-docker の直近 5 件のワークフロー実行を一覧表示して」
• 「microsoft/vscode リポジトリのワークフローを表示して」
• 「owner/repo の実行 ID 12345 の詳細を取得して」
• 「my-org/my-repo の実行 ID 67890 で失敗したジョブを再実行して」
• 「現在実行中のワークフロー実行 ID 11111 をキャンセルして」
• 「owner/repo の最新の実行からアーティファクトを一覧表示して」
• 「my-org/my-app の staging ブランチで deploy.yml ワークフローをトリガーして」
• 「このプロジェクトの最新 CI 実行のステータスは？」

開発

npm install
npm run typecheck
npm run build
npm test
npm run lint
npm run format

関連項目

その他の MCP サーバーや開発者向けツールは、私のポートフォリオをご覧ください。

作者

---

_{README Builder で作成した README}

ライセンス

MIT © 2026 Ofer Shapira