KubeSphere MCP Server は、KubeSphere API と統合するモデルコンテキストプロトコル(MCP)サーバーで、KubeSphere からリソースを取得できます。 Workspace Management, Cluster Management, [User and Roles], [Extensions Center]]の4つのツールモジュールに分割します。

前提条件

クベスフィアクラスターが必要です。 内容:アクセスアドレス、ユーザー名、パスワード

インストール

##KSConfig の生成 フォーマットはkubeconfigに似ています。 この設定には、HTTP コネクタ情報が含まれています。 KubeSphere のデフォルトコンテキストは kubesphere] で、環境変数 [KUBESPHERE_CONTEXT] で変更できます。

[ :オプション KubeSphere が HTTPS 経由でアクセスされたときに base64 でエンコードされた形式で CA 証明書を記入します。 [ :必須 HTTPS アドレスでなければなりません。 (HTTP を使用する場合は、HTTPS アドレスを入力し、パラメータ [[--ks-apiserver http://xxx]] で変更します) [ :必須 KubeSphere クラスターのユーザ。 [ :必須 KubeSphere クラスターユーザのパスワード。

ks-mcp-server バイナリの取得

コマンド[go build -o ks-mcp-server cmd/main.goを実行したり、(github releases)[[[https://github.com/kubesphere/ks-mcp-server/releases]からダウンロードしたりできます

KubeSphere MCP Server

The KubeSphere MCP Server is a Model Context Protocol(MCP) server that provides integration with KubeSphere APIs, enabling to get resources from KubeSphere. Divided into four tools modules: Workspace Management, Cluster Management, User and Roles, Extensions Center.

Prerequisites

You must have a KubeSphere cluster. contains: Access Address, Username, Password.

Installation

Generate KSConfig

The format is similar to kubeconfig. This configuration contains HTTP connector information. The default context for KubeSphere is kubesphere, which can be modified via the environment variable KUBESPHERE_CONTEXT.

apiVersion: v1
clusters:
- cluster:
    certificate-authority-data: 
    server: 
  name: kubesphere
contexts:
- context:
    cluster: kubesphere
    user: admin
  name: kubesphere
current-context: kubesphere
kind: Config
preferences: {}
users:
- name: admin
  user:
    username: 
    password: 

: **Optional**. Fill in the CA certificate in base64-encoded format when KubeSphere is accessed via HTTPS. : Required Must be an HTTPS address. (If using HTTP, enter any HTTPS address here, then modify via the parameter --ks-apiserver http://xxx)
: **Required** The user for the KubeSphere cluster. : Required The password for the KubeSphere cluster user.

Get ks-mcp-server binary

you can run command go build -o ks-mcp-server cmd/main.go or download from (github releases)[https://github.com/kubesphere/ks-mcp-server/releases] and then move it to $PATH.

Configuration MCP Server in AI Agent

Claude Desktop

1. According to Claude Desktop should change the MCP Configuration. like:

{
  "mcpServers": {
    "KubeSphere": {
      "args": [
        "stdio",
        "--ksconfig", "",
        "--ks-apiserver", ""
      ],
      "command": "ks-mcp-server"
    }
  }
}

: **Required** The absolute path of the ksconfig file. : Optional (but required for HTTP access) The access address of the KubeSphere cluster, supporting either the ks-console or ks-apiserver service address (e.g., http://172.10.0.1:30880).

2. chat with mcp server

Cursor

1. According to Curosr should change the MCP Configuration. like:

{
  "mcpServers": {
    "KubeSphere": {
      "args": [
        "stdio",
        "--ksconfig", "",
        "--ks-apiserver", ""
      ],
      "command": "ks-mcp-server"
    }
  }
}