Github Workflow Debugger

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

GitHub APIを使用して、GitHub Actionsワークフローの障害を診断および修復するためのマルチ選択プロンプト（MCP）ユーティリティです。

🚀 クイックスタート

このツールは、GitHub Actionsワークフローの障害を診断および修復するために設計されています。構造化された決定木を通じて、GitHub APIを利用してワークフローの実行情報を取得し、失敗状況を分析し、実行可能な解決策を提供します。

✨ 主な機能

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

📦 インストール

Smitheryを使用したインストール

Smithery を通じて、Claude Desktopで使用するために githubworkflowmcp を自動インストールします。

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 は、モデルコンテキストプロトコル（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 build

プロジェクト構造

• src/index.ts - MCPサーバーの主要なエントリポイント
• build/ - コンパイルされたJavaScriptファイル