FluxCD MCP Server

Flux MCP Server

Flux MCP Server は、Flux Operator を実行している Kubernetes クラスターに AI アシスタントを直接接続し、自然言語による GitOps の分析とトラブルシューティングを可能にします。

Flux MCP Server と AI アシスタントを使用すると、次のことができます。

• Flux リソースからアプリケーションログまで、GitOps パイプラインをエンドツーエンドでデバッグする
• デプロイに失敗した原因をインテリジェントに分析する
• クラスター間で Flux の設定と Kubernetes リソースを比較する
• クラスターの状態から生成された図で Flux の依存関係を可視化する
• 対話形式のプロンプトを使って Flux に操作を指示する

クイックスタート

Homebrew を使って Flux MCP Server をインストールします。

brew install controlplaneio-fluxcd/tap/flux-operator-mcp

その他のインストール方法については、インストールガイドを参照してください。

次の設定を AI アシスタントの MCP 設定に追加します。

{
  "flux-operator-mcp":{
    "command":"flux-operator-mcp",
    "args":[
      "serve",
      "--read-only=false"
    ],
    "env":{
      "KUBECONFIG":"/path/to/.kube/config"
    }
  }
}

/path/to/.kube/config を kubeconfig ファイルの絶対パスに置き換えてください。 次のコマンドで確認できます。echo $HOME/.kube/config

MCP Server は、初期化時に組み込みの指示を AI アシスタントに通知します。 手順に沿ったトラブルシューティングを行うには、 instructions.md にある AI ルールをコピーし、アシスタント用の適切なファイルに配置してください。

AI アシスタントアプリを再起動し、次のプロンプトで MCP Server をテストします。

• 「kubeconfig で利用できるクラスターコンテキストを教えてください」
• 「現在のクラスターで実行されている Flux のバージョンを教えてください」

MCP Server を Claude、Cursor、GitHub Copilot などのアシスタントと使用する方法について詳しくは、 ドキュメントサイトを参照してください。

ドキュメント

• Flux MCP Server の概要
• インストールガイド
• トランスポートモードとセキュリティ設定
• 効果的なプロンプト作成ガイド
• MCP ツールのリファレンス

コントリビューション

Flux MCP Server プロジェクトへの GitHub プルリクエストによるコントリビューションを歓迎します。 開発環境のセットアップ方法やプロジェクトへの貢献を始める方法については、 CONTRIBUTING ガイドを参照してください。

ライセンス

MCP Server はオープンソースであり、AGPL-3.0 licenseのもとでライセンスされている Flux Operator プロジェクトの一部です。