Github Actions MCP Server

🚀 GitHub Actions MCP サーバー

GitHub Actions の MCP サーバーは、人工知能アシスタントに GitHub Actions ワークフローの管理と操作を可能にします。

✨ 主な機能

• 完全なワークフロー管理：ワークフローの一覧表示、詳細表示、トリガー、キャンセル、再実行が可能です。
• ワークフロー実行分析：ワークフローの実行詳細とそのジョブの情報を取得できます。
• 包括的なエラー処理：明確なエラーメッセージと強化された詳細情報を提供します。
• 柔軟な型検証：堅牢な型チェックを行い、API の変異を適切に処理します。
• セキュリティ指向の設計：タイムアウト処理、レート制限、厳格な URL 検証が実装されています。

📚 ツールリスト

1. list_workflows

   • リポジトリ内のワークフローを一覧表示します。
   • 入力パラメータ：
     • owner (文字列)：リポジトリの所有者（ユーザー名または組織名）
     • repo (文字列)：リポジトリ名
     • page (オプションの数値)：ページングのページ番号
     • perPage (オプションの数値)：1 ページあたりの結果数（最大 100）
   • 戻り値：リポジトリ内のワークフローのリスト

2. get_workflows

   • 指定された所有者のワークフローを取得します。
   • 入力パラメータ：
     • owner (文字列)：リポジトリの所有者
   • 戻り値：所有者の詳細なワークフロー情報

3. trigger_workflow

   • 指定されたワークフローの実行をトリガーします。
   • 入力パラメータ：
     • owner (文字列)：リポジトリの所有者
     • repo (文字列)：リポジトリ名
     • workflow_id (文字列)：ワークフロー ID
     • ref (文字列)：コード参照（ブランチ、タグ、またはコミットハッシュ）
     • inputs (オブジェクト)：ワークフローに渡す入力パラメータ
   • 戻り値：トリガーされた実行の状態情報

4. get_workflow_run

   • 指定されたワークフローの実行詳細情報を取得します。
   • 入力パラメータ：
     • owner (文字列)：リポジトリの所有者
     • repo (文字列)：リポジトリ名
     • run_id (文字列)：実行 ID
   • 戻り値：実行の詳細情報

5. list_workflow_runs

   • 指定されたワークフローのすべての実行を一覧表示します。
   • 入力パラメータ：
     • owner (文字列)：リポジトリの所有者
     • repo (文字列)：リポジトリ名
     • workflow_id (文字列)：ワークフロー ID
   • 戻り値：ワークフローの実行リスト

💻 使用例

基本的な使用法

ワークフローの一覧表示

const result = await listWorkflows({
  owner: "your-username",
  repo: "your-repository"
});

ワークフローのトリガー

const result = await triggerWorkflow({
  owner: "your-username",
  repo: "your-repository", 
  workflowId: "ci.yml",
  ref: "main",
  inputs: {
    environment: "production"
  }
});

設定例

claude_desktop_config.json に以下を追加します。

{
  "mcpServers": {
    "github-actions": {
      "command": "node",
      "args": [
        "<path-to-mcp-server>/dist/index.js"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

📦 インストール

リポジトリをクローンしてビルドします。

git clone https://github.com/ko1ynnky/github-actions-mcp-server.git
cd github-actions-mcp-server
npm install
npm run build

これにより、MCP サーバーを実行するために必要なファイルが dist ディレクトリに生成されます。

📚 ドキュメント

よくある質問

1. 認証エラー：
   • GitHub トークンが正しい権限を持っていることを確認してください。
   • トークンが環境変数として正しく設定されていることを確認してください。
2. レート制限：
   • このサーバーは GitHub API の制限に達しないようにレート制限を実装しています。
   • レート制限エラーが発生した場合は、リクエスト頻度を下げてください。
3. 型検証エラー：
   • GitHub API の応答は予想される構造と異なる場合があります。
   • このサーバーは柔軟な検証を実装して、ほとんどのバリエーションを処理できます。
   • 継続的なエラーが発生する場合は、問題報告を開いてください。

📄 ライセンス

この MCP サーバーは MIT ライセンスの下で公開されています。