Kubesphere

🚀 KubeSphere MCP 服務器

KubeSphere MCP 服務器是一個 模型上下文協議 (MCP) 服務器，它提供了與 KubeSphere API 的集成能力，允許用戶從 KubeSphere 中獲取資源。該服務器分為四個工具模塊，分別為：工作區管理、集群管理、用戶和角色、擴展中心。

🚀 快速開始

在使用 KubeSphere MCP 服務器之前，您需要完成一些先決條件的準備，然後進行安裝和配置。

✨ 主要特性

• 提供與 KubeSphere API 的集成，方便從 KubeSphere 獲取資源。
• 具備四個工具模塊，涵蓋工作區、集群、用戶角色和擴展中心的管理。

📦 安裝指南

先決條件

您必須擁有一個 KubeSphere 集群，同時需要準備好該集群的訪問地址、用戶名以及密碼。

生成 KSConfig

KSConfig 的格式類似於 kubeconfig，此配置包含 HTTP 連接器信息。KubeSphere 的默認上下文是 kubesphere，您可以通過環境變量 KUBESPHERE_CONTEXT 對其進行修改。

apiVersion: v1
clusters:
- cluster:
    certificate-authority-data: <CA 文件>
    server: <服務器地址>
  name: kubesphere
contexts:
- context:
    cluster: kubesphere
    user: admin
  name: kubesphere
current-context: kubesphere
kind: Config
preferences: {}
users:
- name: admin
  user:
    username: <KubeSphere 用戶名>
    password: <KubeSphere 密碼>

• <CA 文件>：可選。當您通過 HTTPS 訪問 KubeSphere 時，需要填寫 Base64 編碼的 CA 證書。
• <服務器地址>：必需 必須是 HTTPS 地址。（如果您使用 HTTP，請在此處填寫任何 HTTPS 地址，然後通過參數 --ks-apiserver http://xxx 進行修改）
• <KubeSphere 用戶名>：必需 KubeSphere 集群的用戶。
• <KubeSphere 密碼>：必需 KubeSphere 用戶的密碼。

獲取 ks-mcp-server 二進制文件

您可以通過以下兩種方式獲取 ks-mcp-server 二進制文件：

• 運行命令 go build -o ks-mcp-server cmd/main.go 進行編譯。
• 從 github 發佈 下載，然後將其移動到 $PATH。

在 AI 代理中配置 MCP 服務器

Claude Desktop

1. 根據 Claude Desktop 的需求更改 MCP 配置。示例如下：

{
  "mcpServers": {
    "KubeSphere": {
      "args": [
        "stdio",
        "--ksconfig", "<ksconfig 文件的絕對路徑>",
        "--ks-apiserver", "<KubeSphere 地址>"
      ],
      "command": "ks-mcp-server"
    }
  }
}

• <ksconfig 文件的絕對路徑>：必需 ksconfig 文件的絕對路徑。
• <KubeSphere 地址>：可選（但 HTTP 訪問時必需） KubeSphere 集群的訪問地址，支持 ks-console 或 ks-apiserver 服務地址（例如 http://172.10.0.1:30880）。

2. 使用 MCP 服務器聊天

Cursor

1. 根據 Cursor 的需求更改 MCP 配置。示例如下：

{
  "mcpServers": {
    "KubeSphere": {
      "args": [
        "stdio",
        "--ksconfig", "<ksconfig 文件的絕對路徑>",
        "--ks-apiserver", "<KubeSphere 地址>"
      ],
      "command": "ks-mcp-server"
    }
  }
}

• <ksconfig 文件的絕對路徑>：必需 ksconfig 文件的絕對路徑。
• <KubeSphere 地址>：可選（但 HTTP 訪問時必需） KubeSphere 集群的訪問地址，支持 ks-console 或 ks-apiserver 服務地址（例如 http://172.10.0.1:30880）。

2. 使用 MCP 服務器聊天