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

GitHub API を使用して GitHub Actions ワークフローの障害を診断および修正するための Multi-Choice Prompt (MCP) ユーティリティ。

概要

このツールは、構造化された意思決定ツリーを通じて、GitHub Actions ワークフローの障害を診断および修正するのに役立ちます。GitHub API を使用してワークフロー実行情報を取得し、障害を分析し、実用的な解決策を提供します。

Related MCP server: GitHub MCP Server

特徴

• リポジトリの最近の失敗したワークフロー実行を取得する

• ワークフロー実行ジョブとステップを分析する

• 一般的な失敗パターンを特定する

• 一般的な問題に対する具体的な解決策を提案する

• ワークフロー ファイルの表示と更新

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の githubworkflowmcp を自動的にインストールするには:

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

手動インストール

# Clone the repository
git clone https://github.com/yourusername/github-workflow-debugger-mcp.git
cd github-workflow-debugger-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Link the binary for local use
npm link

使用法

GitHub ワークフローデバッガー MCP は、モデルコンテキストプロトコル (MCP) をサポートする AI アシスタントで使用するために設計されています。GitHub Actions ワークフローの障害を診断および修正するために使用できるツールが複数用意されています。

必要な権限

このツールを使用するには、次の権限を持つ 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. まず、最近失敗したワークフロー実行を取得します。

   I need to check recent failed workflow runs for my repository "username/repo".

2. 特定の失敗した実行を分析します。

   Can you analyze workflow run #123456 and suggest fixes?

3. ワークフロー ファイルを表示します。

   Show me the content of the workflow file at .github/workflows/main.yml

4. ワークフロー ファイルを修正して更新します。

   Update the workflow file with the suggested fixes.

発達

前提条件

• Node.js 16以上

• npmまたはyarn

設定

# Install dependencies
npm install

# Build the project
npm run build

プロジェクト構造

• src/index.ts - MCP サーバーのメインエントリポイント

• build/ - コンパイルされたJavaScriptファイル

ライセンス

ISC