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 服務器的環境變量列表：

📚 詳細文檔

工具