MCP Cyclops

サイクロプスMCPは、AIエージェントがモデルコンテキストプロトコルを通じてKubernetesアプリケーションを安全に管理およびデプロイできるツールで、テンプレート検証とアプリケーションの作成/更新機能を提供します。

開発者ツールクラウドプラットフォーム #Kubernetes管理 #AIエージェント #アプリケーションデプロイ #テンプレート検証 .Go

スコア : 2.5ポイント

ダウンロード数 : 0

更新時間 : 2025-09-03

サイトを開く

サイクロプスMCPとは？

サイクロプスMCP（モデルコンテキストプロトコル）は、Kubernetes用に設計されたAIエージェントサーバーで、AIアシスタント（Cursor、Claudeなど）が安全な高度な抽象化を通じてコンテナ化アプリケーションの作成、更新、管理を行えます。

サイクロプスMCPの使い方は？

サイクロプスMCPサーバーをインストールし、AIエージェントの接続を設定するだけで、複雑なYAML設定を深く理解することなく、自然言語指令でKubernetesアプリケーションのデプロイと管理を開始できます。

適用シナリオ

開発チームによるマイクロサービスの迅速なデプロイ、CI/CDパイプラインの自動化、開発環境の管理、およびコンテナ化アプリケーションの頻繁な更新と調整が必要なシナリオに適しています。

主要機能

新しいモジュールを作成する

テンプレートと構成値を指定して、Kubernetesアプリケーションの新しいモジュールを迅速に作成します。

モジュール情報を取得する

名前で既存のモジュールの詳細情報と現在の状態を検索します。

すべてのモジュールをリストする

クラスター内でデプロイされたすべてのサイクロプスモジュールのリストを表示します。

モジュール構成を更新する

既存のモジュールの構成パラメータとデプロイ設定を安全に変更します。

テンプレートスキーマ検証

作成または更新前に、構成値がテンプレート仕様に準拠していることを自動的に検証します。

テンプレートストレージ管理

利用可能なアプリケーションテンプレートライブラリの管理とクエリを行います。

利点

Kubernetesの複雑さを抽象化し、開発者とAIの両方がコンテナアプリケーションを簡単に管理できるようにします。

高度なリソース操作により、構成エラーのリスクを減らします。

本番環境で使用可能なアプリケーションのデプロイを保証します。

UIによるワンクリックインストールや手動デプロイなど、複数のインストール方法をサポートします。

主流のAIエージェントツール（Cursorなど）とシームレスに統合されます。

制限

Kubernetesクラスターにサイクロプスプラットフォームを事前にデプロイする必要があります。

現在は主にサイクロプスモジュール形式のアプリケーションのデプロイをサポートしています。

基本的なKubernetesクラスターへのアクセス権が必要です。

使い方

サイクロプスプラットフォームをインストールする

KubernetesクラスターにサイクロプスコントロールプレーンとUIがインストールされていることを確認します。

MCPサーバーをインストールする

サイクロプスUIのプラグインページからMCPサーバーをワンクリックでインストールします。

MCPサービスを公開する

ポートフォワーディングを使用してMCPサーバーをローカルに公開します。

AIエージェントを構成する

AIツールの構成にMCPサーバーの接続を追加します。

使用例

Webアプリケーションを迅速にデプロイする

AIエージェントを通じてNginx Webサーバーを迅速にデプロイします。

アプリケーション構成を更新する

実行中のアプリケーションのリソース構成を動的に調整します。

環境チェック

現在デプロイされているすべてのアプリケーションの状態を確認します。

よくある質問

サイクロプスMCPにはどのような前提条件が必要ですか？

どのようなAIエージェントツールがサポートされていますか？

デプロイの安全性をどのように確保しますか？

カスタムテンプレートはサポートされていますか？

🚀 Cyclops MCP (Model Context Protocol)

Cyclops MCPは、お好きなAIエージェントがKubernetesアプリケーションを管理できるようにします。Cyclops MCPサーバーは、エージェントが既存のアプリケーションを安全に作成および更新するためのツールを提供します。

https://github.com/user-attachments/assets/0c675c33-1e36-4fdb-bf8c-2fd7fb491e6b

これにより、すべての既存のテンプレートとそれらのスキーマを確認し、正確で本番環境で使用可能なアプリケーションを作成できます。エージェントは、Kubernetesリソース（Deployments、Services、Ingresses）の各行に触れるのではなく、高レベルのリソース（Cyclops Modules）を作成するため、誤設定の可能性が大幅に減少します。

これにより、迅速に動作し、見逃された誤設定が本番環境に影響を与えないことを保証できます。

Cyclopsと私たちのMCPを使用することで、開発者とAIエージェントからKubernetesの複雑さを抽象化できます

🚀 クイックスタート

📦 インストール

UIを通じたインストール

Cyclops MCPサーバーをインストールする最も簡単な方法は、Cyclops UIを通じることです。以下にバイナリとkubectlを使用してインストールする方法を説明しますが、推奨されるインストール方法はUIを通じるものです。

⚠️ 重要提示

UIを通じてCyclops MCPをインストールするには、Cyclopsをバージョンv0.20.1以上で実行する必要があります。

サイドバーの “Addon” > "MCP server" に移動してCyclops MCPをインストールします。"Install Cyclops MCP server" をクリックすると、数秒でCyclops MCPサーバーが起動します。
MCPサーバーが起動したら、クラスター外に公開し、AIエージェントを接続するだけです。

ローカルホストでMCPサーバーを公開するには、以下のコマンドでポート転送を行うことができます。
```
kubectl port-forward -n cyclops svc/cyclops-mcp 8000:8000
```
サーバーは現在 localhost:8000 で利用可能です。
AIエージェントに接続するには、その設定にCyclops MCPサーバーを指定するだけです。たとえば、Cursorに追加するには、以下のJSONを追加することができます。
```
{
  "mcpServers": {
    "cyclops-kubernetes": {
      "url": "http://localhost:8000/sse"
    }
  }
}
```

これで、AIコンパニオンと新しい会話を開始できます。上記はCursorでの使用例です。

標準入力バイナリのインストール

1. CyclopsがKubernetesクラスターにインストールされていることを確認する

単一のコマンドでインストールする方法については、ドキュメントを参照してください - https://cyclops-ui.com/docs/installation/install/manifest

2. MCPサーバーをダウンロードする

以下のコマンドでCyclops MCPサーバーのバイナリをダウンロードできます。

GOBIN="$HOME/go/bin" go install github.com/cyclops-ui/mcp-cyclops/cmd/mcp-cyclops@latest

3. サーバー設定を追加する

⚠️ 重要提示

デフォルトでは、Cyclops MCPは .kube/config ファイルを使用してクラスターに接続します。

MCP Cyclopsサーバーを構成します。

{
  "mcpServers": {
    "mcp-cyclops": {
      "command": "mcp-cyclops"
    }
  }
}

設定

Cyclops MCPサーバーは環境変数を介して構成できます。以下は、Cyclopsアプリケーションを管理する際にCyclops MCPサーバーが使用するkubeconfigファイルを指定する設定の例です。

{
  "mcpServers": {
    "mcp-cyclops": {
      "command": "mcp-cyclops",
      "env": {
        "KUBECONFIG": "/path/to/your/kubeconfig"
      }
    }
  }
}

環境変数

Cyclops MCPサーバーを構成するために使用される環境変数のリストを以下に示します。

属性	详情
`KUBECONFIG`	kubeconfigファイルへのパス（オプション、デフォルトはクラスター内構成または $HOME/.kube/config）
`CYCLOPS_KUBE_CONTEXT`	使用するKubernetesコンテキスト（オプション）
`CYCLOPS_MODULE_NAMESPACE`	モジュールが格納される名前空間
`CYCLOPS_HELM_RELEASE_NAMESPACE`	Helmリリースの名前空間
`CYCLOPS_MODULE_TARGET_NAMESPACE`	モジュールのターゲット名前空間

Kubernetesクラスターへの手動インストール

それぞれの開発者が mcp-cyclops バイナリをインストールする代わりに、SSEをトランスポートタイプとして使用するCyclops MCPサーバーをKubernetesクラスターにインストールし、すべての開発者が同じサーバーに接続できるようにすることができます。

インストールする前に、CyclopsとそのすべてのCRDがクラスターにインストールされていることを確認します。

Cyclopsポッドが実行されていることを確認します。

kubectl get pods -n cyclops

以下のように表示されるはずです。

NAME                            READY   STATUS    RESTARTS   AGE
cyclops-ctrl-676b5d9789-ntcls   1/1     Running   0          94s
cyclops-ui-7798655f97-xdg29     1/1     Running   0          94s

CRDがインストールされていることを確認します。

kubectl get crds | grep cyclops-ui

以下のように表示されるはずです。

modules.cyclops-ui.com             2025-04-26T15:28:18Z
templateauthrules.cyclops-ui.com   2025-04-26T15:28:18Z
templatestores.cyclops-ui.com      2025-04-26T15:28:18Z

以下のコマンドでCyclops MCPサーバーをインストールします。

kubectl apply -f https://raw.githubusercontent.com/cyclops-ui/mcp-cyclops/refs/heads/main/install/mcp-server.yaml

現在、cyclops-mcp サービスを公開できます。MCPサーバーをテストするには、ポート転送を行うことができます。
```
kubectl port-forward svc/cyclops-mcp -n cyclops 8000:8000
```
Cyclops MCPサーバーのホスト、またはテスト中の場合は、MCPサービスをポート転送した localhost アドレスを追加します。
```
{
  "mcpServers": {
    "mcp-cyclops": {
      "url": "http://localhost:8000/sse"
    }
  }
}
```

💻 使用例

基本的な使用法

上述のインストール手順に従って、Cyclops MCPサーバーを起動し、AIエージェントに接続することで、Kubernetesアプリケーションの管理を開始できます。

高度な使用法

以下のツールを利用して、より高度な操作を行うことができます。

ツール名	説明
`create_module`	新しいモジュールを作成します。このツールを呼び出す前に、`get_template_schema` を呼び出して、指定されたテンプレートの値を検証してください。
`get_module`	名前でモジュールを取得します。
`list_modules`	すべてのCyclopsモジュールをリストします。
`update_module`	名前でモジュールを更新します。このツールを呼び出す前に、`get_template_schema` を呼び出して、指定されたテンプレートの値を検証してください。
`get_template_schema`	指定されたテンプレートのJSONスキーマを返します。`create_module` ツールを呼び出す前に確認する必要があります。
`get_template_store`	名前でテンプレートストアを取得します。
`list_template_store`	クラスターからテンプレートストアをリストします。