Cyclops MCP (Model Context Protocol)

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 サーバーを設定するために使用される環境変数の一覧です:

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

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

   1. Cyclops の Pod が実行中であることを確認します:

      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
      

   2. 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
      

2. 次のコマンドで Cyclops MCP サーバーをインストールします:

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

3. これで cyclops-mcp サービスを公開できます。MCP サーバーをテストするには、ポートフォワードできます:

   kubectl port-forward svc/cyclops-mcp -n cyclops 8000:8000
   

4. Cyclops MCP サーバーのホスト、またはテストしている場合は MCP サービスをポートフォワードした localhost アドレスを追加します:

   {
     "mcpServers": {
       "mcp-cyclops": {
         "url": "http://localhost:8000/sse"
       }
     }
   }