GitHub Action トリガー MCP サーバー
GitHub Actions 統合用のモデル コンテキスト プロトコル サーバー。
概要
これは、GitHub Actions との統合用に設計された TypeScript ベースの MCP サーバーです。以下の機能を提供します。
- リポジトリから利用可能な GitHub Actions を取得するためのツール
- 特定のGitHubアクションに関する詳細情報を取得するためのツール
- GitHub ワークフロー ディスパッチ イベントをトリガーするためのツール
- GitHub リポジトリから最新のリリースを取得するためのツール
特徴
ツール
get_github_actions
- リポジトリで利用可能な GitHub Actions を取得する- 必須パラメータ:
owner
(リポジトリの所有者、ユーザー名または組織) およびrepo
(リポジトリ名) - オプションパラメータ:
token
(GitHub 個人アクセストークン、プライベートリポジトリへのアクセスや API レート制限の増加に使用) - ワークフローID、名前、パス、状態、URL、コンテンツを含むJSONデータを返します。
- 必須パラメータ:
get_github_action
- 入力やその要件など、特定の GitHub Action に関する詳細情報を取得します。- 必須パラメータ:
owner
(アクションの所有者、ユーザー名または組織) およびrepo
(アクションのリポジトリ名) - オプションパラメータ:
path
: アクション定義ファイルへのパス (デフォルト: 'action.yml')ref
: Git 参照 (ブランチ、タグ、またはコミット SHA、デフォルト: 'main')token
: GitHub個人アクセストークン(オプション)
- 名前、説明、作成者、入力(および必須かどうか)など、アクションに関する詳細情報を返します。
- 必須パラメータ:
trigger_github_action
- GitHubワークフローをトリガーし、関連するパラメータを渡す- 必須パラメータ:
owner
: リポジトリの所有者(ユーザー名または組織)repo
: リポジトリ名workflow_id
: トリガーするワークフローのIDまたはファイル名
- オプションパラメータ:
ref
: ワークフローをトリガーする git 参照 (デフォルト: 'main')inputs
: ワークフローに渡す入力(ワークフローの定義済み入力と一致する必要があります)token
: GitHub 個人アクセストークン (ワークフロースコープが必要です)
- ステータス、URL などを含むワークフロー実行情報を返します。
- 必須パラメータ:
get_github_release
- GitHub リポジトリから最新の 2 つのリリースを取得します- 必須パラメータ:
owner
(リポジトリの所有者、ユーザー名または組織) およびrepo
(リポジトリ名) - オプションパラメータ:
token
(GitHub 個人アクセストークン、オプション) - 最新の2つのリリースに関する情報を返します
- 必須パラメータ:
インストール
推奨インストール: npx の使用
インストールして使用する最も簡単な方法は、手動でローカルにインストールせずに、Claude Desktop 構成ファイルでnpx
コマンドを使用することです。
この方法の利点:
- ローカルパッケージのインストールは不要
- 最新バージョンを自動的に使用します
- 一度設定すればすぐに使用可能
- 組み込みのGitHubトークン設定
ローカルインストール
手動でインストールする場合は、次の手順に従ってください。
- パッケージをインストールします。
- Claude Desktop 構成での使用:
MacOS の場合: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows の場合: %APPDATA%/Claude/claude_desktop_config.json
GitHubトークンの設定
GitHub API(特にプライベートリポジトリやワークフロートリガー)にアクセスするには、GitHub個人アクセストークンを設定する必要があります。設定方法はいくつかあります。
方法 1 (推奨): Claude Desktop での直接設定
Claude Desktop 構成ファイルのenv
フィールドを使用してトークンを直接設定します。
方法2: グローバル環境変数
GITHUB_TOKEN
環境変数を設定します。
方法3: ローカル構成ファイル
設定ファイルを編集します。
GitHub トークンを設定します。
この構成ファイルのテンプレートは、サーバーの初回起動時に自動的に作成されます。
発達
依存関係をインストールします:
サーバーを構築します。
開発中の自動再構築の場合:
デバッグ
デバッグには MCP Inspector を使用します。
インスペクターは、ブラウザでデバッグ ツールにアクセスするための URL を提供します。
npmへの公開
このパッケージを npm に公開する場合は、次の手順に従ってください。
- npm にログインしていること、および
@nextdrive
組織に公開する権限があることを確認してください。 - プロジェクトをビルドします。
- npm に公開します (組織スコープのパッケージはデフォルトでは非公開ですが、公開するには
--access public
を使用します)。
公開後は、誰でもnpx @nextdrive/github-action-trigger-mcp
コマンドを使用してこのツールを実行したり、Claude Desktop 構成で使用したりできます。
使用例
GitHub Actionsのリストを取得する
リポジトリの GitHub Actions を取得するには、 get_github_actions
ツールを使用してください。
デフォルトのトークンが設定されている場合は、プライベート リポジトリにアクセスするときに自動的に使用されます。
応答例:
詳細なGitHubアクション情報の取得
特定のアクションに関する詳細情報を取得するには、 get_github_action
ツールを使用します。
応答例:
GitHubワークフローのトリガー
GitHub ワークフローをトリガーするには、 trigger_github_action
ツールを使用してください。
応答例:
注: ワークフローをトリガーするには以下が必要です。
- ワークフローは
workflow_dispatch
イベントをサポートするように設定する必要があります - GitHubトークンには
workflow
スコープ権限が必要です - 渡される入力パラメータはワークフローで定義されたものと一致する必要があります
最新リリースの入手
get_github_release
ツールを使用して、リポジトリから最新の 2 つのリリースを取得します。
応答例:
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
GitHub Actions との統合を可能にするモデル コンテキスト プロトコル サーバー。これにより、ユーザーは利用可能なアクションを取得したり、特定のアクションに関する詳細情報を取得したり、ワークフロー ディスパッチ イベントをトリガーしたり、リポジトリ リリースを取得したりできます。
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server for Git repository interaction and automation. This server provides tools to read, search, and manipulate Git repositories via Large Language Models.Last updated -1254,281JavaScriptMIT License
- -securityFlicense-qualityEnables interaction with GitHub issues via the Model Context Protocol, allowing users to list and create issues with secure authentication.Last updated -Python
- AsecurityAlicenseAqualityA Model Context Protocol server that enables Large Language Models to interact with Git repositories through a robust API, supporting operations like repository initialization, cloning, file staging, committing, and branch management.Last updated -2154882TypeScriptApache 2.0
- AsecurityFlicenseAqualityA Model Context Protocol server that enables AI models to interact with GitHub's API, allowing for repository creation and management with descriptions, topics, and website URLs through natural language commands.Last updated -1JavaScript