Github MCP Server Devops

メインダッシュボードは以下を提供します。

• 🎯 ビジュアルゲージ付きのDevOps成熟度スコア
• 📈 DORAメトリクスの概要（デプロイ頻度、リードタイム、変更失敗率、MTTR）
• ⚡ CI/CDパイプラインの健全性概要
• 💰 コスト分析のハイライト
• 🔒 セキュリティとコンプライアンスの状態
• 詳細レポートへのクイックナビゲーション

4つの主要なDORAメトリクスを追跡します。

• デプロイ頻度 — 本番環境へのリリース頻度
• 変更のリードタイム — コミットから本番環境への時間
• 変更失敗率 — 障害を引き起こすデプロイの割合
• 平均復旧時間 — インシデントから回復する速度

各メトリクスには、トレンド分析と業界標準（エリート、ハイ、ミディアム、ローのパフォーマー）とのベンチマークが含まれています。

CI/CDパイプラインを詳細に調査します。

• 🔄 ワークフローの成功率とトレンド
• ⏱️ P95/P99レイテンシーを含む平均実行時間
• 🚨 失敗分析と一般的なエラーパターン
• 📊 リポジトリごとおよびワークフローごとの内訳
• 🏃 キュー時間とランナー利用率

GitHub Actionsの支出を理解し、最適化します。

• 💵 ランナータイプ（GitHubホスト型とセルフホスト型）別の総コスト
• 📊 リポジトリ、ワークフロー、およびOS別のコスト内訳
• 🎯 コスト節約のための実行可能な推奨事項
• 📈 支出のトレンドと予測
• ⚡ 効率メトリクス（ワークフローごとのコスト、分あたりのコスト）

コンプライアンスとセキュリティを維持します。

• ✅ コンプライアンスフレームワークのカバレッジ（SOC2、ISO27001、HIPAA、PCI-DSS）
• 🔍 シークレットスキャンの状態とアラート
• 🛡️ コードスキャンの結果
• 📋 ブランチ保護ルールのコンプライアンス
• 🔐 GHAS（GitHub Advanced Security）機能の採用状況

DevOpsの成熟度レベルを評価します。

• 📊 ビジュアルゲージ付きの全体的な成熟度スコア
• 🎯 カテゴリ別のスコア（CI/CD、テスト、セキュリティ、監視など）
• 📈 影響度に基づいて優先順位付けされた改善提案
• 🏆 業界標準とのベンチマーク
• 📋 向上のための実行可能なロードマップ

VS CodeのMCP設定（~/.vscode/mcp.jsonまたはワークスペースの.vscode/mcp.json）に以下を追加します。

{
  "servers": {
    "actions-pulse": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "--env-file", "/path/to/.mcp.env",
        "-e", "GITHUB_ORG=your-org-name",
        "ghcr.io/tsviz/actions-pulse:latest"
      ],
      "type": "stdio"
    }
  }
}

{
  "servers": {
    "actions-pulse": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "GITHUB_TOKEN=ghp_your_token",
        "-e", "GITHUB_ORG=your-org-name",
        "ghcr.io/tsviz/actions-pulse:latest"
      ],
      "type": "stdio"
    }
  }
}

{
  "servers": {
    "actions-pulse": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "--env-file", "/path/to/.mcp.env",
        "-e", "GITHUB_ORG=your-org-name",
        "-e", "DEVOPS_CONFIG_PATH=/app/config",
        "-v", "/path/to/your/config:/app/config:ro",
        "ghcr.io/tsviz/actions-pulse:latest"
      ],
      "type": "stdio"
    }
  }
}

repositories/inventory.yamlを作成して、監視対象のリポジトリを定義します。

apiVersion: actions-pulse/v1
kind: RepositoryInventory
metadata:
  name: my-inventory
  version: "1.0.0"
  description: "Repositories to monitor"

spec:
  discovery:
    enabled: false  # 明示的なリポジトリのみを監視

  repositories:
    - name: my-app
      team: platform
      tier: tier-1
      compliance: [SOC2]
      tags: [java, production]

    - name: my-api
      team: backend
      tier: tier-2
      tags: [nodejs, staging]

get_actions_usage_metrics

GitHub Actionsの使用状況と請求データを分析します（基本）。

パラメータ:
- org_name: 組織名（GITHUB_ORGが設定されている場合はオプション）
- timeframe: '24h' | '7d' | '30d'
- breakdown: 'repository' | 'workflow' | 'runner_type'

get_detailed_usage_metrics ⭐

GitHub Insightsスタイルの詳細な使用状況メトリクスを、ワークフロー、ジョブ、リポジトリ、OS、およびランナーごとに内訳して取得します。

パラメータ:
- org_name: 組織名（GITHUB_ORGが設定されている場合はオプション）
- timeframe: '7d' | '30d' | '90d'
- repo_filter: カンマ区切りのリポジトリリスト（オプション）

get_detailed_performance_metrics ⭐

GitHub Insightsスタイルのパフォーマンスメトリクスを、ワークフロー/ジョブ/リポジトリ/OS/ランナーごとの平均実行時間、キュー時間、および失敗率で取得します。

パラメータ:
- org_name: 組織名（GITHUB_ORGが設定されている場合はオプション）
- timeframe: '7d' | '30d' | '90d'
- repo_filter: カンマ区切りのリポジトリリスト（オプション）

get_actions_performance_metrics

P95/P99レイテンシーを含むワークフローパフォーマンス分析を取得します（基本）。

パラメータ:
- org_name: 組織名（GITHUB_ORGが設定されている場合はオプション）
- repo_name: 特定のリポジトリ（オプション）
- workflow_id: 特定のワークフロー（オプション）
- timeframe: '1h' | '6h' | '24h' | '7d'

強化されたコスト検出：レポートは、正確なランナーコスト計算のために3層システムを使用します。

• 🎯 API検出 - ホストされているランナーAPIを使用して正確なマシン仕様を取得します。
• 🏷️ ラベル検出 - ランナーカタログとのパターンマッチング
• 📊 デフォルト価格 - OSベースのフォールバック

詳細については、構成ガイドを参照してください。

analyze_runner_utilization

ランナーの利用率と効率を分析します。

パラメータ:
- org_name: 組織名（GITHUB_ORGが設定されている場合はオプション）
- runner_type: 'self-hosted' | 'github-hosted' | 'all'
- include_costs: コスト分析を含める（デフォルト: true）

get_actions_cache_analytics

Actionsキャッシュの使用状況と効率を分析します。

パラメータ:
- org_name: 組織名（GITHUB_ORGが設定されている場合はオプション）
- repo_name: 特定のリポジトリ（オプション）
- timeframe: '24h' | '7d' | '30d'

generate_cost_optimization_report

実行可能なコスト最適化の推奨事項を生成します。

パラメータ:
- org_name: 組織名（GITHUB_ORGが設定されている場合はオプション）
- include_recommendations: 実行可能な推奨事項を含める（デフォルト: true）
- target_savings_percentage: 目標節約率（5-50、デフォルト: 20）

get_workflow_insights

ボトルネック検出を含むワークフローインサイトを取得します。

パラメータ:
- org_name: 組織名（GITHUB_ORGが設定されている場合はオプション）
- repo_name: リポジトリ名（必須）
- workflow_name: ワークフロー名またはファイル名（必須）
- analyze_dependencies: ジョブの依存関係を分析する（デフォルト: true）

get_team_productivity_metrics

Actionsとコミットデータに基づいてチームの生産性を分析します。

パラメータ:
- org_name: 組織名（GITHUB_ORGが設定されている場合はオプション）
- team_slug: チームスラッグ（オプション）
- include_individuals: 個々のメトリクスを含める（デフォルト: false）
- timeframe: '7d' | '30d' | '90d'

get_compliance_audit_report

コンプライアンスとセキュリティの監査レポートを生成します。

パラメータ:
- org_name: 組織名（GITHUB_ORGが設定されている場合はオプション）
- compliance_framework: 'SOC2' | 'ISO27001' | 'HIPAA' | 'PCI-DSS' | 'CUSTOM'
- include_secrets_scan: シークレットスキャンを含める（デフォルト: true、GHASが必要）

get_dora_metrics

DORAメトリクス（デプロイ頻度、リードタイム、変更失敗率、復旧時間）を取得します。

パラメータ:
- org_name: 組織名（GITHUB_ORGが設定されている場合はオプション）
- timeframe: '7d' | '30d' | '90d'
- repo_filter: カンマ区切りのリポジトリリスト（オプション）

get_enhanced_dora_metrics

実際のGitHub Deployments APIを使用して、最大限の精度でDORAメトリクスを取得します。

パラメータ:
- org_name: 組織名（GITHUB_ORGが設定されている場合はオプション）
- timeframe: '7d' | '30d' | '90d'
- repo_filter: カンマ区切りのリポジトリリスト（オプション）

get_pull_request_metrics

プルリクエストのメトリクス（リードタイム、マージ率、サイズ分布）を取得します。

パラメータ:
- org_name: 組織名（GITHUB_ORGが設定されている場合はオプション）
- timeframe: '7d' | '30d' | '90d'
- repo_name: 特定のリポジトリ（オプション）
- include_stale: 古いPR分析を含める（オプション）

get_issue_metrics

イシューのメトリクス（解決時間、ラベル分布、バックログの健全性）を取得します。

パラメータ:
- org_name: 組織名（GITHUB_ORGが設定されている場合はオプション）
- timeframe: '7d' | '30d' | '90d'
- repo_name: 特定のリポジトリ（オプション）
- label_filter: ラベルでフィルタリング（オプション）

get_deployment_metrics

GitHub Deployments APIからデプロイメントメトリクスを取得します。

パラメータ:
- org_name: 組織名（GITHUB_ORGが設定されている場合はオプション）
- timeframe: '7d' | '30d' | '90d'
- environment: 環境でフィルタリング（オプション）
- repo_filter: カンマ区切りのリポジトリリスト（オプション）

get_environment_metrics

GitHub環境構成（保護ルールを含む）を分析します。

パラメータ:
- org_name: 組織名（GITHUB_ORGが設定されている場合はオプション）
- repo_filter: カンマ区切りのリポジトリリスト（オプション）

get_discussion_metrics

GitHub Discussionsのメトリクス（回答率、エンゲージメント）を取得します。

パラメータ:
- org_name: 組織名（GITHUB_ORGが設定されている場合はオプション）
- repo_name: 特定のリポジトリ（オプション）
- timeframe: '7d' | '30d' | '90d'

get_merge_queue_metrics

リポジトリ全体のマージキューの使用状況と採用状況を取得します。

パラメータ:
- org_name: 組織名（GITHUB_ORGが設定されている場合はオプション）
- repo_name: 特定のリポジトリ（オプション）

get_org_custom_properties

組織のすべてのカスタムプロパティ定義をリストします。

パラメータ:
- org_name: 組織名（GITHUB_ORGが設定されている場合はオプション）

get_custom_properties_analytics

リポジトリ全体のカスタムプロパティの使用状況とカバレッジを分析します。

パラメータ:
- org_name: 組織名（GITHUB_ORGが設定されている場合はオプション）

get_repos_by_property

カスタムプロパティ値でリポジトリを検索します。

パラメータ:
- org_name: 組織名（GITHUB_ORGが設定されている場合はオプション）
- property_name: カスタムプロパティ名（例：team, tier, compliance）
- property_value: フィルタリングするプロパティ値（オプション）

GitHub Enterpriseを持っている場合は、以下を追加することで拡張機能を有効にすることができます。

GITHUB_ENTERPRISE_SLUG=your-enterprise-slug

これにより、以下が有効になります。

• 組織横断的な請求集計
• エンタープライズ全体のランナープール
• 統合された監査ログ

ローカルでビルドする

npm install
npm run build
docker build -t actions-pulse:local .

ローカルで実行する（Dockerなし）

export GITHUB_TOKEN=ghp_your_token
export GITHUB_ORG=your-org
npm start

- name: Setup MCP config
  env:
    GITHUB_TOKEN: ${{ secrets.GH_PAT_DEVOPS }}
  run: |
    mkdir -p ~/.copilot
    printf '%s\n' '{
      "mcpServers": {
        "actions-pulse": {
          "command": "docker",
          "args": ["run", "-i", "--rm", "-e", "GITHUB_TOKEN='"$GITHUB_TOKEN"'", "-e", "GITHUB_ORG=your-org", "ghcr.io/tsviz/actions-pulse:latest"],
          "tools": ["*"]
        }
      }
    }' > ~/.copilot/mcp-config.json

- name: Generate DevOps Report
  env:
    GITHUB_TOKEN: ${{ secrets.GH_PAT_DEVOPS }}
    GH_TOKEN: ${{ secrets.GH_PAT_DEVOPS }}
  run: |
    copilot --yolo \
      --disable-builtin-mcps \
      --additional-mcp-config @$HOME/.copilot/mcp-config.json \
      --prompt "Use the actions-pulse MCP tools to generate a DevOps report..."