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

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

概要

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

特徴

リポジトリの最近の失敗したワークフロー実行を取得する
ワークフロー実行ジョブとステップを分析する
一般的な失敗パターンを特定する
一般的な問題に対する具体的な解決策を提案する
ワークフローファイルの表示と更新

インストール

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 個人アクセストークンに置き換えます。

利用可能なツール

get-failed-workflow-runs - リポジトリの最近の失敗したワークフロー実行を取得します
get-workflow-run-jobs - 特定のワークフロー実行のジョブを取得します
get-workflow-file - ワークフローファイルの内容を取得します
update-workflow-file - 修正を加えてワークフローファイルを更新する
analyze-workflow-failure - 失敗したワークフロー実行を分析し、修正を提案します

使用例

AI アシスタントで GitHub ワークフローデバッガー MCP を使用する方法の例を次に示します。

まず、最近失敗したワークフロー実行を取得します。
I need to check recent failed workflow runs for my repository "username/repo".
特定の失敗した実行を分析します。
Can you analyze workflow run #123456 and suggest fixes?
ワークフローファイルを表示します。
Show me the content of the workflow file at .github/workflows/main.yml
ワークフローファイルを修正して更新します。
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

This server cannot be installed

-

security - not tested

-

license - not tested

-

quality - not tested

実行ログを分析し、一般的な障害パターンを識別し、構造化された意思決定ツリーを通じて具体的な修正を提案することで、GitHub Actions ワークフローの障害を診断して修正するのに役立つユーティリティ。

GitHub Workflow Debugger MCP