KubeSphere

KubeSphere

MCP server integrating KubeSphere APIs to fetch resources via four tool modules.

13
Stars
35
Forks
2
Releases

Overview

The KubeSphere MCP Server is a Model Context Protocol (MCP) server that provides integration with KubeSphere APIs to retrieve resources from a KubeSphere cluster. It is organized into four tool modules: Workspace Management, Cluster Management, User and Roles, and Extensions Center, enabling modular MCP operations for different resource areas. Prerequisites include a running KubeSphere cluster and a KSConfig file (formatted similarly to kubeconfig) containing HTTP connector information. The KSConfig supports a default context named kubesphere, which can be modified via the KUBESPHERE_CONTEXT environment variable. The server can be built with Go (go build -o ks-mcp-server cmd/main.go) or downloaded from GitHub releases and placed in your PATH. The README also shows configuring MCP usage in AI assistants (Claude Desktop and Cursor) by providing the ksconfig path and KubeSphere address via --ksconfig and --ks-apiserver. The server supports HTTPS addresses and provides an HTTP override workflow via --ks-apiserver. This MCP server targets developers, administrators, and AI integrators who need programmatic access to KubeSphere resources through MCP.

Details

Owner
kubesphere
Language
Go
License
Apache License 2.0
Updated
2025-12-07

Features

Resource access via MCP

Fetch resources from KubeSphere through the MCP server integration.

Four modular tool sets

Workspace Management, Cluster Management, User and Roles, Extensions Center to cover core MCP operations.

KSConfig-based configuration

KSConfig format (kubeconfig-like) for HTTP connector and default context support.

KubeSphere context configurability

Default context kubesphere can be modified via the KUBESPHERE_CONTEXT environment variable.

Go-based binary (ks-mcp-server)

Build the server with Go or use the prebuilt binary from GitHub releases.

HTTP/HTTPS flexible addressing

Supports HTTPS server address with optional HTTP override via --ks-apiserver.

AI agent integration

Configure and chat with the MCP server through AI assistants like Claude Desktop or Cursor.

GitHub releases availability

Download ks-mcp-server from GitHub releases and place it in PATH.

Audience

KubeSphere adminsAccess and automate KubeSphere resources through MCP server for management tasks.
MCP developersUse MCP server to fetch KubeSphere resources in custom apps via MCP.
AI integratorsConnect AI agents to access KubeSphere resources via the MCP server.

Tags

KubeSphereMCPMCP ServerWorkspace ManagementCluster ManagementUser and RolesExtensions CenterKSConfigHTTP/HTTPSAI IntegrationsClaude DesktopCursor