Kubesphere

🚀 KubeSphere MCP サーバー

KubeSphere MCP サーバーは、モデルコンテキストプロトコル (MCP) サーバーであり、KubeSphere API との統合を提供し、KubeSphere からリソースを取得できるようにします。このサーバーは 4 つのツールモジュールに分かれています：ワークスペース管理、クラスター管理、ユーザーとロール、拡張センター。

🚀 クイックスタート

前提条件

KubeSphere クラスターが必要です。これには、アクセスアドレス、ユーザー名、パスワードが含まれます。

インストール

1. 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 ユーザーのパスワードです。

2. ks - mcp - server バイナリファイルの取得

コマンド go build -o ks-mcp-server cmd/main.go を実行するか、github のリリース からダウンロードし、$PATH に移動します。

3. 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 サーバーを使用してチャットします。