MCP Cyclops

🚀 Cyclops MCP (模型上下文协议)

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

相关链接

这意味着它可以检查你所有现有的模板及其架构，以创建准确且可用于生产的应用程序。由于你的代理创建的是高级资源（Cyclops 模块），而不是直接操作 Kubernetes 资源（部署、服务和入口）的每一行代码，因此出现错误配置的可能性大大降低。

它使你能够快速行动，并确保生产环境中不会出现未被捕获的错误配置。

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

🚀 快速开始

✨ 主要特性

• 允许 AI 代理管理 Kubernetes 应用程序。
• 提供安全创建和更新应用程序的工具。
• 检查模板及其架构，创建准确的生产应用。
• 降低错误配置的可能性。
• 抽象 Kubernetes 复杂性。

📦 安装指南

通过 UI 安装

安装 Cyclops MCP 服务器最简单的方法是通过 Cyclops UI。以下是通过二进制文件和 kubectl 安装的说明，但建议通过 UI 进行安装。

⚠️ 重要提示

要通过 UI 安装 Cyclops MCP，你应该运行 Cyclops 版本 v0.20.1 或更高版本。

1. 转到侧边栏 “插件” > "MCP 服务器" 来安装 Cyclops MCP。现在你可以点击 "安装 Cyclops MCP 服务器"，你的 Cyclops MCP 服务器将在几秒钟内启动并运行。

2. 现在你的 MCP 服务器已经启动并运行，剩下的就是将其暴露在集群外部，并将你的 AI 代理连接到它。 要在本地主机上暴露 MCP 服务器，你可以使用以下命令进行端口转发：

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

现在你的服务器可以在 localhost:8000 上访问。

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

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

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

安装标准输入二进制文件

1. 确保 Cyclops 已安装在你的 Kubernetes 集群中 检查我们的文档，了解如何使用单个命令进行安装 - 安装文档链接

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"
    }
  }
}

手动安装到 Kubernetes 集群

你可以将 Cyclops MCP 服务器以 SSE 作为传输类型安装到你的 Kubernetes 集群中，而不是让每个开发人员都安装 mcp-cyclops 二进制文件，这样可以让所有开发人员连接到同一台服务器。

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

- **检查 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 服务器 使用以下命令安装 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 地址：

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

🔧 配置

你可以通过环境变量配置 Cyclops MCP 服务器。以下是一个示例，展示了如何添加配置，以指定 Cyclops MCP 服务器在管理你的 Cyclops 应用程序时应使用的 kubeconfig 文件。

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

环境变量

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

📚 详细文档

工具