MCP Cyclops

Cyclops MCP（模型上下文协议）

Cyclops MCP允许您最喜欢的AI代理管理您的Kubernetes应用程序。Cyclops MCP服务器为代理提供了安全创建和更新现有应用程序的工具。

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

这意味着它可以检查所有现有的模板和这些模板的模式，以创建准确且可用于生产的应用程序。您的代理现在有更少的空间进行错误配置，因为它创建了高级资源（Cyclops模块），而不是触及Kubernetes资源的每一行（部署、服务和入口）。

它允许您快速移动，并确保没有未经理解的错误配置影响您的生产。

借助Cyclops和我们的MCP，您现在可以从开发人员和AI代理中抽象出Kubernetes的复杂性

通过UI安装

安装Cyclops MCP服务器的最简单方法是通过Cyclops UI。下面是如何通过二进制文件和kubectl安装它的说明，但推荐的安装方式是通过UI。

⚠️ 要通过UI安装Cyclops MCP，您应该在某个版本上运行Cyclops v0.20.1 或更大

1. 转到侧栏安装Cyclops MCP “Addon” > "MCP server"。您现在可以单击 "Install Cyclops MCP server" 您的Cyclops MCP服务器将在几秒钟内启动并运行。

1. 现在您的MCP服务器已经开始运行，剩下的就是将其暴露在集群之外，并将您的AI代理连接到它。

要在本地主机上公开MCP服务器，您只需使用以下命令进行端口转发：

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

您的服务器现在可以在 localhost:8000.

1. 要将其连接到AI代理，您只需在其配置中提供Cyclops MCP服务器。例如，要将其添加到Cursor，只需使用以下JSON添加即可：

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

现在，您可以与您的AI同伴开始新的对话。上面是我们如何将其与Cursor一起使用的示例。

Install stdin binary

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 Cyclos服务器：

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

配置

您可以通过env变量配置Cyclops MCP服务器。下面是一个添加配置的示例，用于指定Cyclops MCP服务器在管理Cyclops应用程序时应使用的kubeconfig文件。

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

环境变量

以下是用于配置Cyclos MCP服务器的环境变量列表：

______________________________________________________________________

Install to a Kubernetes cluster manually

______________________________________________________________________

而不是让每个开发人员安装 mcp-cyclops 二进制，您可以将带有SSE作为传输类型的Cyclops MCP服务器安装到Kubernetes集群，并允许所有开发人员连接到同一服务器。

1. 在安装之前，请确保Cyclops及其所有CRD都已安装在您的集群中：

1. 检查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

1. 检查是否安装了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

1. 使用以下命令安装Cyclops MCP服务器：

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

1. 现在，您可以公开 cyclops-mcp 服务。要测试您的MCP服务器，您可以将其进行端口转发：

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

1. 添加您的Cyclops MCP服务器主机，或者如果您正在测试它 本地主机 您端口转发MCP服务的地址：

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

______________________________________________________________________

工具