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 服务器聊天