Cloud DevOps MCP Server

Cloud DevOps MCP サーバー

Cloud DevOps MCP サーバーは、Alex C. Godwin による Model Context Protocol v2 サーバーです。インフラストラクチャ、アイデンティティ、Kubernetes、CI/CD、SRE、ソフトウェアサプライチェーンの統制に関する、証拠に基づいた Cloud DevOps 分析を提供します。

v0.14 系では、オプトイン方式の OpsChugex 変更インテリジェンスおよび影響範囲ゲートウェイを追加しています。公開 MCP は、計画された変更、トポロジー、準備状況に関する範囲を限定した証拠を、ホストが設定したプライベート OpsChugex サービスに転送し、変更リスク、影響を受けるトポロジーノード、代表的な影響経路、ブロッカー、警告、証拠の不足を返します。独自の依存関係伝播、リスク重み付け、ブロッカールールは、この公開 MIT リポジトリには含まれていません。

v0.13 系では、オプトイン方式の OpsChugex 高度な FinOps ゲートウェイを追加しています。公開 MCP は、クラウドコスト、使用率、Kubernetes の割り当てに関する範囲を限定した証拠を、ホストが設定したプライベート OpsChugex サービスに転送し、最適化の機会、コスト異常、低額・高額の削減見込み、信頼度、コスト相関、証拠の不足を返します。独自の削減係数、異常しきい値、優先順位付け、重複排除は、この公開 MIT リポジトリには含まれていません。

v0.12 系では、オプトイン方式の OpsChugex クラウドセキュリティ態勢ゲートウェイを追加しています。公開 MCP は、クラウド資産、アイデンティティ、シークレット、ネットワーク到達可能性に関する範囲を限定した証拠を、ホストが設定したプライベート OpsChugex サービスに転送し、セキュリティスコア、リスクレベル、順序付けされた検出結果、攻撃経路、証拠の不足、推奨事項を返します。独自のセキュリティルール、重大度のしきい値、スコアリング、攻撃経路の相関付けは、この公開 MIT リポジトリには含まれていません。

v0.11 系では、オプトイン方式の OpsChugex ポリシーおよびガバナンスゲートウェイを追加しています。公開 MCP は、範囲を限定したリソースの証拠と承認済みの例外メタデータを、ホストが設定したプライベート OpsChugex サービスに送信し、統制に関する検出結果および証拠の不足とともに、合格、要確認、ブロックの判定を返します。独自のプロファイル、ルール、重み付け、例外処理ロジックは、この公開 MIT リポジトリには含まれていません。

v0.10 系では、オプトイン方式の OpsChugex 根本原因インテリジェンスゲートウェイを追加しています。公開 MCP は、範囲を限定したインシデントの証拠を、ホストが設定したプライベート OpsChugex サービスに送信し、証拠に基づいて順位付けされた原因候補、矛盾点、制約、次に行う確認事項を返します。独自の順位付けおよび相関ルールは、この公開 MIT リポジトリには含まれていません。

v0.9 系では、Grafana Tempo および Jaeger v3 のトレース読み取り、サービス依存関係のマッピング、トレーシングのカバレッジ評価、複数ウィンドウの SLO バーンレート分析、トレースと SLO のインシデント相関付けに対応する、分散トレーシングおよび SLO インテリジェンスプレーンを追加しています。v0.8 の本番環境オブザーバビリティおよび運用インテリジェンスプレーンも引き続き利用でき、Prometheus、Grafana、CloudWatch Logs Insights、Kubernetes の健全性、GitHub Actions の診断、クラウドの健全性、FinOps、ドリフトに対応します。AWS、Azure、GCP へのライブアクセスは、引き続き範囲を限定した読み取り専用です。クラウドの変更操作には、意図的に対応していません。

目次

• これが必要な理由
• ツール
• アーキテクチャ
• クイックスタート
• npm からインストール
• MCP クライアント
• 設定
• 認証付き Streamable HTTP
• 公開リリースの検証
• ツール入力の例
• デモ出力
• Docker
• 開発
• セキュリティモデル
• ロードマップ
• 作者

これが必要な理由

AI アシスタントは、明確な入力と一貫した出力を備えた、用途を絞ったツールを呼び出せると、エンジニアリング業務でより役立ちます。このサーバーは、次の用途向けにクラウド DevOps ツールレイヤーを提供します。

• インフラストラクチャ、アイデンティティ、ランタイム、デリバリーを横断したリリースリスクの相関分析。
• Infrastructure as Code のデプロイリスク分析。
• 本番環境のインシデント対応ランブックの生成。
• CI/CD デリバリー準備状況のレビュー。
• SLO エラーバジェットの計算。
• AWS IAM の最小権限レビュー。
• AWS、Azure、GCP のアイデンティティポリシーパック。
• Terraform の破壊的変更、パブリック公開、暗号化に関するセキュリティ分析。
• Kubernetes ワークロードの本番準備状況およびセキュリティポリシー分析。
• GitHub Actions ワークフローのセキュリティおよびデプロイレビュー。
• CycloneDX/SPDX SBOM の品質およびソフトウェアサプライチェーンの相関分析。
• セルフホスト可能なリモートアクセス向けの、オプションの認証付き Streamable HTTP サーバー機能。
• オプションの許可リスト方式による、AWS/Azure/GCP のライブインベントリ、オブザーバビリティ、FinOps、ドリフトシグナル。
• オプションの Grafana Tempo および Jaeger v3 のトレース読み取り、サービス依存関係マップ、SLO バーンレートインテリジェンス。
• メトリクス、ログ、トレース、Kubernetes、クラウド、Terraform、CI/CD の証拠を横断する、オプションの OpsChugex プライベート根本原因インテリジェンス。
• 開発、ステージング、本番、規制対象のプロファイル向けの、オプションの OpsChugex プライベートポリシーおよびガバナンスインテリジェンス。
• 公開範囲、アイデンティティ、シークレット、攻撃経路分析を行う、オプションの OpsChugex プライベートクラウドセキュリティポスチャーインテリジェンス。
• 適正サイジング、異常検知、Kubernetes とクラウドのコスト相関分析、節約額の範囲分析を行う、オプションの OpsChugex プライベート高度 FinOps インテリジェンス。
• 変更前の依存関係伝播、影響範囲のマッピング、ブロッカー、ロールバック／準備状況分析を行う、オプションの OpsChugex プライベート変更インテリジェンス。

ツール

ツール	目的
assess_cloud_change_bundle	Terraform、IAM、Kubernetes、GitHub Actions の証拠を相関分析し、ドメイン横断の変更経路を含む、単一のデプロイリスク評価を行います。
assess_terraform_change	Terraform/IaC のリスクをスコアリングし、生の Terraform plan JSON から証拠を導き出すこともできます。
build_incident_runbook	サービス、症状、環境、重大度に応じた実践的なインシデント対応ランブックを作成します。
review_cicd_pipeline	失敗した統制と不明な証拠を分けて、CI/CD の成熟度をレビューします。
estimate_slo_error_budget	一貫性を検証しながら、ダウンタイムとリクエスト失敗の予算を計算します。
review_iam_policy	IAM ポリシーの JSON を解析し、ワイルドカードの適用範囲と権限昇格経路を検出します。
review_kubernetes_deployment	Kubernetes YAML を解析し、プローブ、リソース、中断保護、イメージ、公開に関するリスクを確認します。
review_github_actions_workflow	ワークフロー YAML を解析し、トリガー、不変のアクションピン、権限、キャッシュ、並行実行を確認します。
review_cloud_identity_policy	AWS IAM、Azure RBAC、または GCP IAM のポリシーパックを生のポリシー JSON に適用します。
review_terraform_security	Terraform plan JSON をレビューし、破壊的変更、パブリック公開、暗号化、削除保護、ワイルドカード IAM を確認します。
review_kubernetes_security	特権モード、ホストアクセス、サービスアカウント、ケイパビリティ、seccomp、ルートファイルシステム、NetworkPolicy をレビューします。
review_software_supply_chain	CycloneDX/SPDX SBOM の品質を、CI アクションのピン留め、イメージの不変性、署名、来歴と相関分析します。

オプションのライブマルチクラウド読み取り

明示的に有効にすると、許可リストに基づく AWS／Azure／GCP の ID 検証、範囲を限定したインベントリ、マネージド Kubernetes の検出、オブザーバビリティ設定の概要、FinOps の無駄を示すシグナル、ドリフトのレポートを提供する 6 つの追加ツールが利用できます。クラウドを変更するコマンドは公開されません。AWS の一般的なインベントリは Resource Groups Tagging API を使用するため、タグのない AWS リソースは、そのインベントリや AWS のドリフト比較に表示されない場合があります。

オプションの本番オブザーバビリティインテリジェンス

明示的に有効にすると、範囲を限定した Prometheus クエリ、Grafana アラートの概要、CloudWatch Logs Insights クエリ、Kubernetes ポッドの健全性の概要、GitHub Actions の失敗診断、複数シグナルのインシデント相関、クラウド健全性評価、デプロイとインシデントの相関、オブザーバビリティカバレッジの評価、FinOps 相関、ランタイムを横断したドリフト分析、運用ブリーフを提供する 12 個の追加ツールが利用できます。エンドポイント、クラウドスコープ、ロググループ、クラスターコンテキスト、名前空間、リポジトリは許可リストに登録します。このレイヤーは読み取り専用であり、アラートの変更、デプロイの変更、任意のシェル実行はできません。

オプションの分散トレーシングおよび SLO インテリジェンス

明示的に有効にすると、範囲を限定した Tempo／Jaeger のトレース検索と取得、サービス依存関係のマッピング、トレーシングカバレッジの評価、複数ウィンドウでの SLO バーンレート分析、トレースと SLO のインシデント相関を提供する 6 つの追加 v0.9 ツールが利用できます。リモートのトレーシングエンドポイントは許可リストに登録し、ループバック接続でない限り HTTPS を使用する必要があります。バックエンドの認証情報はホストの環境変数に保持されます。トレース検索の時間範囲と結果数には上限があり、このプレーンではトレースの取り込み、サンプリングの変更、テレメトリの削除はできません。

オプションの OpsChugex 根本原因インテリジェンス

明示的に有効にすると、v0.10 で diagnose_root_cause が利用できます。このツールは、メトリクス、ログ、トレース、Kubernetes、クラウド、Terraform、CI/CD から範囲を限定した証拠を受け取り、ホストで設定されたプライベート OpsChugex サービスを呼び出します。パブリック MCP に独自のランキングルールは含まれず、ツール入力としてサービス URL や認証情報を受け取らず、修復も実行しません。証拠スコアは統計的な確率ではなく、証拠の強さを表します。

オプションの OpsChugex ポリシーおよびガバナンスインテリジェンス

明示的に有効にすると、v0.11 で assess_governance_policy が利用できます。このツールは、範囲を限定した事実に基づくリソース証拠に加え、任意で所有者が特定された期間限定の例外を受け取り、プライベート OpsChugex ポリシーエンジンに転送します。制御に関する所見と証拠の不足を含む pass、review、または block を返します。

パブリック MCP に独自のガバナンスプロファイル、ポリシールール、スコアリングの重み付け、例外評価ロジック、または強制機能は含まれません。サービス URL とトークンはホスト側に保持され、MCP 引数として指定することはできません。

オプションの OpsChugex クラウドセキュリティ態勢インテリジェンス

明示的に有効にすると、v0.12 で assess_cloud_security_posture が利用できます。このツールは、範囲を限定した資産、ID、シークレット、ネットワーク到達可能性の証拠を受け取り、プライベート OpsChugex セキュリティエンジンに転送します。セキュリティスコア、リスクレベル、優先順位付きの所見、相関する攻撃経路、証拠の不足、推奨される次のアクションを返します。

パブリック MCP に独自のセキュリティ検出しきい値、重大度ルール、スコアリングロジック、攻撃経路アルゴリズムは含まれません。認証情報のローテーション、IAM の変更、ネットワーク制御の変更、暗号化設定の変更、インフラストラクチャの修復はできません。

オプションの OpsChugex 高度な FinOps インテリジェンス

明示的に有効にすると、v0.13 で analyze_advanced_finops が公開されます。このツールは、範囲を限定したクラウドコスト、利用状況、Kubernetes の割り当てに関する証拠を受け取り、プライベートな OpsChugex FinOps エンジンに転送します。最適化の機会、異常、節約額の範囲、信頼度、コストの相関関係、証拠の不足を返します。

公開 MCP には、独自の節約係数、異常のしきい値、優先順位付けルール、信頼度のアルゴリズム、ポートフォリオの重複排除ロジックは含まれていません。リソースのサイズ変更、ワークロードの終了、コミットメントの購入、Kubernetes のリクエストの変更、請求処理は行いません。

オプションの OpsChugex 変更インテリジェンスと影響範囲分析

明示的に有効にすると、v0.14 で analyze_change_blast_radius が公開されます。このツールは、範囲を限定した変更予定項目、トポロジーのノード／エッジ、準備状況を示す証拠を受け取り、プライベートな OpsChugex 変更インテリジェンスエンジンに転送します。リスクレベル／スコア、影響を受けるノード、代表的な影響経路、ブロッカー、警告、証拠の不足、推奨事項を返します。

公開 MCP には、独自のグラフ伝播アルゴリズム、変更リスクの重み、本番環境のブロッカールール、承認ロジックは含まれていません。このツールは読み取り専用であり、Terraform の適用、Kubernetes の変更、プルリクエストのマージ、ワークロードのデプロイ、変更の承認、ロールバックの実行はできません。

オプションのインフラストラクチャ運用

明示的に有効にすると、Terraform のフォーマット／検証／プランの要約と、Kubernetes の読み取り専用ランタイム検査を行う 6 つの追加ツールが利用できます。これらの操作では、リポジトリ、コンテキスト、名前空間、リソースの許可リストを使用します。Terraform の完全なプラン JSON、Kubernetes Secrets、任意のシェル実行、Terraform の apply、Kubernetes の変更は意図的に対象外としています。

アーキテクチャ

flowchart TD
  LocalClient["Local MCP client"] --> Stdio["stdio"]
  RemoteClient["Remote MCP client"] --> HTTPS["HTTPS reverse proxy / gateway"]
  HTTPS --> AuthHTTP["Bearer-authenticated Streamable HTTP"]
  Stdio --> Server["Cloud DevOps MCP server"]
  AuthHTTP --> Server
  Server --> DomainTools["Domain + policy-pack analyzers"]
  DomainTools --> Correlator["Cross-domain and supply-chain correlation"]
  DomainTools --> Output["Structured guidance"]
  Correlator --> Output

クイックスタート

公開済みの MCP サーバーを npm から直接実行します。

npx -y [email protected]

スクリプトの実行ポリシーにより npx.ps1 がブロックされる Windows PowerShell システムでは、次を使用します。

npx.cmd -y [email protected]

npm からインストール

ローカルコマンドを継続して使用する場合は、CLI をグローバルにインストールします。

npm install -g [email protected]
cloud-devops-mcp-server

このパッケージは npm で cloud-devops-mcp-server として公開されており、公式 MCP Registry に io.github.alexcgodwin/cloud-devops-mcp-server として登録されています。

MCP クライアント

Cloud DevOps MCP Server は、ローカル stdio クライアントと、Streamable HTTP エンドポイントに接続できる MCP クライアントに対応しています。一般的なローカルクライアントは次のとおりです。

• Cursor
• Claude Desktop
• MCP に対応した VS Code
• Claude Code
• Model Context Protocol の stdio トランスポートに準拠するその他のクライアント

通常のローカル運用には stdio を使用します。セルフホストのリモートアクセスでは、オプションの認証付き Streamable HTTP エンドポイントを起動し、ローカル以外へのデプロイは HTTPS リバースプロキシまたはゲートウェイの背後に配置してください。

設定

ローカル stdio サーバーに対応している MCP クライアントには、次の公開設定を推奨します。

{
  "mcpServers": {
    "cloud-devops": {
      "command": "npx",
      "args": ["-y", "[email protected]"]
    }
  }
}

npx がブロックされた PowerShell ラッパー経由で解決される場合、Windows クライアントでは npx.cmd を使用できます。

{
  "mcpServers": {
    "cloud-devops": {
      "command": "npx.cmd",
      "args": ["-y", "[email protected]"]
    }
  }
}

npm、グローバルインストール、ソース開発、認証付き Streamable HTTP の設定オプションについては、docs/configuration.md を参照してください。

認証付き Streamable HTTP

ローカルループバックの例：

$env:CLOUD_DEVOPS_MCP_BEARER_TOKEN="<random secret at least 32 characters>"
npm run start:http

MCP エンドポイントは http://127.0.0.1:3000/mcp で、Authorization: Bearer <token> が必要です。ローカル以外のアドレスにバインドする場合は、さらに CLOUD_DEVOPS_MCP_ALLOWED_HOSTS と HTTPS の CLOUD_DEVOPS_MCP_PUBLIC_BASE_URL が必要です。これにより、リモートトラフィックはリバースプロキシまたはゲートウェイで TLS を終端することを前提とします。

公開リリースの検証

v0.14.0 リリース候補は 116 件の自動テストに合格しており、ステートメントカバレッジは 85.80％、ブランチカバレッジは 72.18％、関数カバレッジは 85.89％、行カバレッジは 89.11％です。本番依存関係の監査で、脆弱性は 0 件と報告されています。公開後に、クリーンインストールと MCP Registry の受け入れ確認を記録します。

検証記録については、docs/public-acceptance.md を参照してください。

ツール入力の例

{
  "changedResources": ["network", "iam", "kubernetes"],
  "includesIamChanges": true,
  "includesPublicIngress": true,
  "modifiesStatefulResources": false,
  "hasRollbackPlan": true,
  "hasPeerReview": true,
  "hasTerraformPlan": true
}

出力形式の例：

{
  "riskScore": 78,
  "riskLevel": "critical",
  "changedResources": ["network", "iam", "kubernetes"],
  "recommendedReleasePath": "Change-advisory review, maintenance window and staged execution are recommended."
}

デモ出力

ツールセット全体の実用的な入力例と出力例については、docs/demo.md をご覧ください。

Docker

コンテナー内でサーバーをビルドして実行します。

docker build -t cloud-devops-mcp-server .
docker run --rm -i cloud-devops-mcp-server

開発

npm run dev
npm run build
npm test
npm run check

中核となる判断ロジックは src/logic.ts にあり、MCP ツールの登録は src/index.ts にあります。

プロジェクトに関する詳しい情報は、DEVELOPMENT.md、RELEASE.md、docs/architecture.md をご覧ください。

セキュリティモデル

• Stdio がデフォルトであり、シークレットは不要です。
• オプションの Streamable HTTP では、32 文字以上のベアラートークンが必要です。
• ローカル以外の HTTP バインドには、明示的な Host 許可リストと、リバースプロキシ／ゲートウェイで終端するための HTTPS 公開ベース URL が必要です。
• Host と Origin の検証は、公式の MCP Fastify アダプターを通じて有効になります。
• デフォルトの分析ツールでは、クラウド認証情報は不要で、クラウド API も呼び出しません。
• オプションの Terraform／Kubernetes 操作では、明示的な有効化と許可リストへの登録後に、ローカルで設定されたプロバイダーまたはクラスターの認証情報を使用する場合があります。
• オプションのライブクラウド読み取りでは、既存の AWS CLI、Azure CLI、または gcloud の認証を使用し、アカウント／サブスクリプション／プロジェクトの明示的な許可リストが必要です。
• オプションの本番環境オブザーバビリティ読み取りでは、明示的なエンドポイント／リソースの許可リストと、ホスト管理の認証情報が必要です。返されるログと診断情報は、範囲が制限され、機密情報がマスキングされます。
• オプションの v0.10 根本原因インテリジェンスでは、ホストで設定された HTTPS エンドポイントとホスト側トークンを使用します。いずれもツール引数として受け付けられず、独自のランキングエンジンは公開リポジトリの外部にあります。
• オプションの v0.11 ガバナンスインテリジェンスでは、個別に制御されるホスト設定の HTTPS エンドポイントと、同じホスト側の OpsChugex トークンを使用します。独自のポリシールールと適用機能は、公開リポジトリの外部にあります。
• オプションの v0.12 クラウドセキュリティ態勢インテリジェンスでは、専用のフェイルクローズゲートとホスト設定の HTTPS エンドポイントを使用します。独自のセキュリティスコアリングと攻撃経路の相関分析は、非公開の OpsChugex コアにあります。
• オプションの v0.13 高度な FinOps インテリジェンスでは、専用のフェイルクローズゲートとホスト設定の HTTPS エンドポイントを使用します。独自のコスト削減、異常検知、優先順位付け、重複排除のロジックは、非公開の OpsChugex コアにあります。
• オプションの v0.14 変更インテリジェンスでは、専用のフェイルクローズゲートとホスト設定の HTTPS エンドポイントを使用します。独自の依存関係の波及、リスクの重み付け、ブロッカーロジックは、非公開の OpsChugex コアにあります。
• クラウドを変更するツールは公開されません。
• 分析はデフォルトで読み取り専用です。制御された実行は、明示的に有効化され、許可リストに登録された場合にのみ可能です。
• 汎用シェルツールや強制プッシュ機能は公開されません。
• 保護されたブランチへの直接のコミット／プッシュは禁止されており、影響の大きい GitHub 操作には明示的な確認が必要です。
• 分析結果は参考情報です。オプションの運用ツールは、明示的な許可リストと固定されたコマンド／API の範囲によって制限されます。

ロードマップ

• 現在：v0.14.0 変更インテリジェンスと影響範囲の分析 - 変更前の依存関係の伝播、影響を受けるサービスのマッピング、ブロッカーと準備状況の分析を行う、公開ゲートウェイから非公開の OpsChugex へのアクセスを提供します。
• v0.15.0 制御された修復ゲートウェイ - 選択したクラウド、Kubernetes、Terraform の運用上の問題に対する、安全な修正を承認制で実施します。
• v0.16.0 複数アカウント／複数組織の運用 - AWS Organizations、Azure のテナント／サブスクリプション、GCP の組織／プロジェクトのトポロジーに対応します。
• v0.17.0 インシデント指揮と自動化されたランブック - インシデントのタイムライン、証拠バンドル、修復計画、ロールバックの推奨事項、インシデント後のレポートを提供します。
• v0.18.0 プラットフォームエンジニアリングインテリジェンス - サービスカタログ、オーナーシップ、ゴールデンパス、環境の健全性、開発者プラットフォームのチェックに対応します。
• v0.19.0 エンタープライズ認証と認可 - OAuth/OIDC、RBAC、ユーザーごとのスコープ、ホスト型 MCP へのアクセス制御の強化、監査証跡に対応します。
• v1.0.0 本番環境向け安定版リリース - 安定したツールコントラクト、互換性の保証、強化されたセキュリティモデル、包括的なドキュメント、エンタープライズ対応のリリース基準を提供します。

作者

Alex C. Godwin によって構築されました。クラウド DevOps エンジニアです。