MCP-巨眼服务器

Name: MCP-巨眼服务器
Author: cyclops-ui

作者：cyclops-ui29 星标更新：2025-06-25

项目介绍

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，您应该运行版本v0.20.1或更高版本的Cyclops

安装Cyclops MCP，前往侧边栏“插件” > "MCP服务器"。您可以点击"安装Cyclops MCP服务器"，几秒钟后您的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的例子。

<details> <summary>安装stdin二进制文件</summary>

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文件连接到您的集群

配置您的Cyclops MCP服务器：

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

配置

您可以通过环境变量来配置Cyclops MCP服务器。下面是一个指定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`	模块的目标命名空间

</details> <details> <summary> 手动安装到Kubernetes集群 </summary>

与其让每个开发人员都安装mcp-cyclops二进制文件，不如将Cyclops MCP服务器安装到您的Kubernetes集群中，并允许所有开发人员连接到同一个服务器。

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

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

检查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"
    }
  }
}
```

</details>

工具

工具	描述
`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`	列出集群中的模板存储