gha-intel-mcp
GitHub Actions ワークフローのタイミング分析、設定監査、課金インサイトのための MCP サーバー。
ツール
ツール | 説明 |
| 最近のワークフロー実行の平均、最小、最大、p95 の所要時間統計を計算します。 |
| ワークフロー YAML を評価し、キャッシュ、並列性、並行処理、アーティファクト、チェックアウト深度、タイムアウト、ランナーの固定、Docker キャッシュ、トリガーを確認します。 |
| ランナータイプ別の Actions の課金分数と推定コスト、およびリポジトリごとのキャッシュ使用率を返します。 |
Related MCP server: copilot-usage-mcp
要件
Node.js >= 18(ネイティブの
fetchを使用)repoとread:orgスコープを持つ GitHub 個人アクセストークン
セットアップ
3 つのトランスポートモードが利用可能です。デプロイ環境に合わせて選択してください。
オプション A: stdio(ローカル、デスクトップクライアント推奨)
サーバーは MCP クライアントのサブプロセスとして stdin/stdout 上で実行されます。ネットワークポートは不要です。
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
%APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"gha-intel": {
"command": "npx",
"args": ["-y", "@barissozudogru/gha-intel-mcp"],
"env": {
"GITHUB_TOKEN": "ghp_your_token"
}
}
}
}Claude Code
claude mcp add gha-intel -e GITHUB_TOKEN=ghp_your_token -- npx -y @barissozudogru/gha-intel-mcpCursor
~/.cursor/mcp.json
{
"mcpServers": {
"gha-intel": {
"command": "npx",
"args": ["-y", "@barissozudogru/gha-intel-mcp"],
"env": {
"GITHUB_TOKEN": "ghp_your_token"
}
}
}
}Windsurf
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"gha-intel": {
"command": "npx",
"args": ["-y", "@barissozudogru/gha-intel-mcp"],
"env": {
"GITHUB_TOKEN": "ghp_your_token"
}
}
}
}VS Code + Copilot
.vscode/mcp.json(ワークスペース)またはユーザー設定
{
"servers": {
"gha-intel": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@barissozudogru/gha-intel-mcp"],
"env": {
"GITHUB_TOKEN": "ghp_your_token"
}
}
}
}Cline
Cline の設定を開き、MCP Servers に移動して追加します:
{
"mcpServers": {
"gha-intel": {
"command": "npx",
"args": ["-y", "@barissozudogru/gha-intel-mcp"],
"env": {
"GITHUB_TOKEN": "ghp_your_token"
}
}
}
}Continue.dev
~/.continue/config.yaml
mcpServers:
- name: gha-intel
command: npx
args:
- -y
- "@barissozudogru/gha-intel-mcp"
env:
GITHUB_TOKEN: ghp_your_tokenZed
~/.config/zed/settings.json
{
"context_servers": {
"gha-intel": {
"command": {
"path": "npx",
"args": ["-y", "@barissozudogru/gha-intel-mcp"],
"env": {
"GITHUB_TOKEN": "ghp_your_token"
}
}
}
}
}JetBrains(IntelliJ、PyCharm、WebStorm など)
Settings > Tools > AI Assistant > MCP に移動して追加します:
{
"mcpServers": {
"gha-intel": {
"command": "npx",
"args": ["-y", "@barissozudogru/gha-intel-mcp"],
"env": {
"GITHUB_TOKEN": "ghp_your_token"
}
}
}
}オプション B: HTTP(リモートまたはクラウドクライアント)
HTTP モードでサーバーを起動し、クライアントをエンドポイントに接続します:
GITHUB_TOKEN=ghp_your_token npx @barissozudogru/gha-intel-mcp --http
# Server listens on http://0.0.0.0:3000/mcp
# Health check: http://localhost:3000/healthまたは、フラグの代わりに環境変数で設定します:
TRANSPORT=http PORT=3000 GITHUB_TOKEN=ghp_your_token npx @barissozudogru/gha-intel-mcpCursor(HTTP)
~/.cursor/mcp.json
{
"mcpServers": {
"gha-intel": {
"url": "http://localhost:3000/mcp"
}
}
}VS Code + Copilot(HTTP)
.vscode/mcp.json
{
"servers": {
"gha-intel": {
"type": "http",
"url": "http://localhost:3000/mcp"
}
}
}Windsurf(HTTP)
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"gha-intel": {
"serverUrl": "http://localhost:3000/mcp"
}
}
}Continue.dev(HTTP)
~/.continue/config.yaml
mcpServers:
- name: gha-intel
url: http://localhost:3000/mcpオプション C: Docker
docker build -t gha-intel-mcp .
docker run -p 3000:3000 -e GITHUB_TOKEN=ghp_your_token gha-intel-mcpコンテナはデフォルトで HTTP モードで起動します。クライアントを http://localhost:3000/mcp に向けてください。
ツールリファレンス
list_workflow_performance
実際の実行タイミングデータを取得し、ジョブレベルの統計を計算します。
パラメータ | 型 | 必須 | 説明 |
| string | はい | GitHub オーナー(ユーザーまたは組織) |
| string | はい | リポジトリ名 |
| string | はい | ワークフローファイル名(例: |
| number | いいえ | 分析する最近の実行数(デフォルト: 10、最大: 100) |
出力: ジョブごとおよびステップごとのタイミング統計(平均、最小、最大、p95)、実行全体のタイミング、最近の実行結果のリスト。
analyze_workflow_config
ワークフロー YAML を解析し、最適化の機会を監査します。
パラメータ | 型 | 必須 | 説明 |
| string | はい | ワークフローファイルの完全な YAML コンテンツ |
出力: 重大度(critical / warning / info / good)ごとにグループ化された、9 つのカテゴリにわたる調査結果。それぞれに具体的な推奨事項が含まれます。
分析対象カテゴリ: 依存関係キャッシュ、マトリックス戦略と fail-fast、並行処理グループと cancel-in-progress、アーティファクトのアップロード、git checkout の深度、ジョブの timeout-minutes、ランナーバージョンの固定、Docker レイヤーキャッシュ、トリガーのパスフィルター。
get_billing_usage
課金とキャッシュ消費データを取得します。
パラメータ | 型 | 必須 | 説明 |
| string | はい | GitHub ユーザー名または組織 |
| string | いいえ | リポジトリ単位のキャッシュと実行統計のためのリポジトリ名 |
出力: 使用済み合計分数、プラン使用率、ランナータイプ別(Ubuntu / macOS / Windows / large runners)の推定コスト、さらにリポジトリごとのキャッシュサイズと使用率。
環境変数
変数 | 必須 | 説明 |
| はい | GitHub 個人アクセストークン。プライベートリポジトリには |
| いいえ |
|
| いいえ | HTTP モードで実行するときの HTTP ポート(デフォルト: |
ライセンス
MIT
Available Tools
3 toolsanalyze_workflow_configAnalyze Workflow ConfigA
Parse a GitHub Actions workflow YAML (provided as a string) and identify optimization opportunities: missing caches, matrix strategy, concurrency controls, slow dependency installs, artifact handling, and more.
Inputs: workflow_content (required).
get_billing_usageGet Billing UsageA
Retrieve GitHub Actions billing and cache usage statistics for an owner (user or org), optionally scoped to a specific repository.
Inputs: owner (required), repo.
list_workflow_performanceList Workflow PerformanceA
Fetch the last N workflow runs and compute job-level timing statistics (avg, min, max, p95) across those runs. Useful for identifying slow jobs and trends.
Inputs: repo (required), owner (required), workflow_id (required), count.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool addresses a clearly distinct aspect: runtime performance metrics, static configuration analysis, and billing/cost usage. There is no overlap in purpose or data source, so an agent can reliably select the right tool.
All tool names follow a consistent verb_noun pattern: list_workflow_performance, analyze_workflow_config, get_billing_usage. The verbs (list, analyze, get) and nouns clearly indicate the action and subject, maintaining uniformity across the set.
With only 3 tools, the server is minimally scoped but each tool serves a distinct, valuable function within the GitHub Actions intel domain. The count is within the typical 3-15 range, though one could argue it's slightly on the lower end for comprehensive coverage.
The tools cover performance metrics, config analysis, and billing, but there's a notable gap: no tool to fetch the workflow YAML directly, forcing an external step for configuration analysis. Additionally, lifecycle operations like listing workflows or runs are missing, though performance stats partially address that.
Maintenance
Related MCP Connectors
Create, deploy, and operate MCP servers directly from your GitHub repositories.
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
MCP server for building and testing AI agents with multi-model experimentation and insights.
MCP server for Appcircle mobile CI/CD platform.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for GitHub Actions — view workflow runs, read logs, re-run failed jobs, and manage CI/CD.955 npm5MIT
- AlicenseAqualityDmaintenanceAn MCP server that retrieves GitHub Copilot usage metrics and seat assignment data across Enterprise, Organization, and Team levels. It allows users to monitor code completions, chat activity, and active user counts through integrated tools.5MIT
- AlicenseNot gradedqualityDmaintenanceA production-ready MCP server that provides AI assistants with comprehensive GitHub developer tooling including PR analysis, code review, changelog generation, dependency auditing, commit summarization, and refactoring suggestions.MIT
- AlicenseAqualityDmaintenanceAn MCP server that enables AI agents to perform comprehensive GitHub security audits across org settings, repositories, Actions workflows, secrets, supply chain, and access control using 39 tools and 45 checks.39110 npm15MIT