Github Workflow Debugger

🚀 GitHub ワークフローデバッガ MCP

このツールは、GitHub API を通じて GitHub Actions ワークフローの障害を診断し、修復するための多选提示（MCP）ツールです。GitHub Actions ワークフローの障害を迅速に特定し、解決策を提供することができます。

🚀 クイックスタート

このツールは、GitHub API を使用してワークフローの実行情報を取得し、失敗したケースを分析し、実行可能な解決策を提供します。ユーザーは、構造化された決定木を通じて GitHub Actions ワークフローの障害を診断し、修復することができます。

✨ 主な機能

• リポジトリの最近の失敗したワークフロー実行を取得します。
• ワークフロー実行のジョブとステップを分析します。
• 一般的な失敗パターンを識別します。
• 一般的な問題の具体的な修正方法を提案します。
• ワークフローファイルを表示および更新します。

📦 インストール

Smithery を通じたインストール

Smithery を通じて自動的に githubworkflowmcp を Claude デスクトップにインストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @Maxteabag/githubworkflowmcp --client claude

手動インストール

# リポジトリをクローンする
git clone https://github.com/yourusername/github-workflow-debugger-mcp.git
cd github-workflow-debugger-mcp

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

# ローカルで使用するためにリンクする
npm link

💻 使用例

基本的な使用法

GitHub ワークフローデバッガ MCP は、Model Context Protocol (MCP) をサポートする AI アシスタントと連携するように設計されています。以下は、いくつかの使用例です。

必要な権限

このツールを使用するには、GitHub の個人アクセストークン（PAT）が必要です。以下の権限を付与する必要があります。

• repo - プライベートリポジトリの完全なコントロール
• workflow - GitHub Action ワークフローの更新

このトークンを環境変数 GITHUB_PERSONAL_ACCESS_TOKEN に設定する必要があります。

設定

MCP をサポートするクライアントと一緒に使用する場合、以下のように設定できます。

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

<YOUR_TOKEN> をあなたの GitHub 個人アクセストークンに置き換えてください。

利用可能なツール

1. get-failed-workflow-runs - リポジトリの最近の失敗したワークフロー実行を取得します。
2. get-workflow-run-jobs - 特定のワークフロー実行のジョブを取得します。
3. get-workflow-file - ワークフローファイルの内容を取得します。
4. update-workflow-file - 提案された修正方法を使用してワークフローファイルを更新します。
5. analyze-workflow-failure - 失敗したワークフロー実行を分析し、修正方法を提案します。

具体的な使用例

以下は、AI アシスタントと一緒に GitHub ワークフローデバッガ MCP を使用する例です。

1. 最近の失敗したワークフロー実行を取得する：

リポジトリ "username/repo" の最近の失敗したワークフロー実行を確認したい。

2. 特定の失敗した実行を分析する：

ワークフロー実行 #123456 を分析し、修正方法を提案してもらえますか？

3. ワークフローファイルの内容を表示する：

.github/workflows/main.yml のワークフローファイルの内容を表示してください。

4. 提案された修正方法を使用してワークフローファイルを更新する：

提案された修正方法を使用してワークフローファイルを更新してください。

🔧 技術詳細

開発環境の前提条件

• Node.js 16 以上
• npm または yarn

プロジェクトのセットアップ

# ターミナルで以下のコマンドを実行して、プロジェクトをセットアップし、開発サーバーを起動します。
npm install
npm run dev

貢献ガイド

このプロジェクトに貢献する方法については、貢献ガイド を参照してください。

📄 ライセンス

ISC ライセンス