k8s-manage

Kubernetes Cluster Management

通过 K8s MCP Server 管理 Kubernetes 集群。支持多种 MCP 连接方式（mcporter、Cursor 内置 MCP、SSE / Streamable HTTP），覆盖集群信息查询、工作负载 CRUD、诊断、备份恢复、节点运维等 35 个工具。

---

环境变量

使用本 Skill 前，用户需要提供以下信息（按连接方式选填）：

变量	说明	示例
K8S_MCP_URL	MCP Server 的 Streamable HTTP / SSE 地址	http://localhost:8000/mcp
K8S_MCP_TOKEN	JWT 认证 Token（MCP Server 启用认证时必填）	eyJhbGciOi...
K8S_MCP_SERVER	mcporter 中注册的 MCP Server 名称	k8s-mcp-server

---

MCP 连接方式

本 Skill 支持三种方式调用 K8s MCP Server，按优先级自动选择：

方式一：Cursor 内置 MCP（推荐）

如果 K8s MCP Server 已在 Cursor 的 MCP 配置中注册（~/.cursor/mcp.json 或项目 .cursor/mcp.json），直接使用 CallMcpTool 调用：

{
  "mcpServers": {
    "k8s-mcp-server": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

调用方式：

CallMcpTool(server="k8s-mcp-server", toolName="<工具名>", arguments={...})

带认证时，需要在 MCP 配置的 headers 中加上 Token：

{
  "mcpServers": {
    "k8s-mcp-server": {
      "url": "http://localhost:8000/mcp",
      "headers": {
        "Authorization": "Bearer <K8S_MCP_TOKEN>"
      }
    }
  }
}

方式二：mcporter 命令行

mcporter 配置（~/.mcporter/config.json 或项目下 .mcporter.json）：

{
  "mcpServers": {
    "k8s-mcp-server": {
      "url": "http://localhost:8000/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer <K8S_MCP_TOKEN>"
      }
    }
  }
}

调用格式：

mcporter call k8s-mcp-server.<工具名> --args '<JSON参数>'

无认证时省略 headers。查看可用工具列表：

mcporter tools k8s-mcp-server

方式三：stdio 模式（本地直连）

无需 HTTP 服务，直接通过 stdio 启动 MCP Server：

Cursor MCP 配置：

{
  "mcpServers": {
    "k8s-mcp-server": {
      "command": "k8s-mcp-server",
      "args": ["--transport", "stdio"],
      "cwd": "<k8s-mcp-server项目路径>"
    }
  }
}

mcporter 配置：

{
  "mcpServers": {
    "k8s-mcp-server": {
      "command": "k8s-mcp-server",
      "args": ["--transport", "stdio"],
      "cwd": "<k8s-mcp-server项目路径>",
      "transport": "stdio"
    }
  }
}