KubeSphere MCP Server

KubeSphere MCP サーバー

KubeSphere MCP サーバーは、KubeSphere API と連携し、KubeSphere からリソースを取得できる Model Context Protocol(MCP) サーバーです。Workspace Management、Cluster Management、User and Roles、Extensions Center の4つのツールモジュールに分かれています。

前提条件

KubeSphere クラスターが必要です。アクセスアドレス、ユーザー名、パスワードを用意してください。

インストール

KSConfig の生成

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

apiVersion: v1
clusters:
- cluster:
    certificate-authority-data: <CA file>
    server: <Server Address>
  name: kubesphere
contexts:
- context:
    cluster: kubesphere
    user: admin
  name: kubesphere
current-context: kubesphere
kind: Config
preferences: {}
users:
- name: admin
  user:
    username: <KubeSphere Username>
    password: <KubeSphere Password>

<CA file>：任意。KubeSphere に HTTPS でアクセスする場合は、CA 証明書を Base64 エンコード形式で入力します。
<Server Address>：必須。HTTPS アドレスを指定してください。（HTTP を使用する場合は、ここに任意の HTTPS アドレスを入力し、パラメーター --ks-apiserver http://xxx で変更してください。）
<KubeSphere Username>：必須。KubeSphere クラスターのユーザーです。
<KubeSphere Password>：必須。KubeSphere クラスターユーザーのパスワードです。

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

go build -o ks-mcp-server cmd/main.go コマンドを実行するか、（github releases)[https://github.com/kubesphere/ks-mcp-server/releases] からダウンロードして、$PATH に配置します。

AI エージェントでの MCP サーバーの設定

Claude Desktop

1. Claude Desktop の手順に従ってMCP設定を変更します。例：

{
  "mcpServers": {
    "KubeSphere": {
      "args": [
        "stdio",
        "--ksconfig", "<ksconfig file absolute path>",
        "--ks-apiserver", "<KubeSphere Address>"
      ],
      "command": "ks-mcp-server"
    }
  }
}

<ksconfig file absolute path>：必須。ksconfig ファイルの絶対パスです。
<KubeSphere Address>：任意（ただし、HTTP アクセスでは必須）。KubeSphere クラスターのアクセスアドレスです。ks-console または ks-apiserver サービスのアドレスを指定できます（例：http://172.10.0.1:30880）。

2. MCP サーバーとチャットします。

Cursor

1. Curosr の手順に従ってMCP設定を変更します。例：

{
  "mcpServers": {
    "KubeSphere": {
      "args": [
        "stdio",
        "--ksconfig", "<ksconfig file absolute path>",
        "--ks-apiserver", "<KubeSphere Address>"
      ],
      "command": "ks-mcp-server"
    }
  }
}

<ksconfig file absolute path>：必須。ksconfig ファイルの絶対パスです。
<KubeSphere Address>：任意（ただし、HTTP アクセスでは必須）。KubeSphere クラスターのアクセスアドレスです。ks-console または ks-apiserver サービスのアドレスを指定できます（例：http://172.10.0.1:30880）。

2. MCP サーバーとチャットします。