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 MCP 服务在管理 Cyclops 应用时应使用的 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 服务主机；如果是在测试，则添加 localhost 地址，即 MCP 服务进行端口转发的地址：

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