kubectl-mcp-server CLI

Command-line interface for kubectl-mcp-server operations.

kubectl-mcp-server操作的命令行界面。

When to Apply

适用场景

Use this skill when:

User mentions: "CLI", "command line", "tool discovery", "server health"
Operations: listing tools, calling tools directly, checking dependencies
Keywords: "doctor", "tools list", "call", "grep", "info"

在以下场景使用该技能：

用户提及："CLI"、"命令行"、"工具发现"、"服务器健康"
操作：列出工具、直接调用工具、检查依赖
关键词："doctor"、"tools list"、"call"、"grep"、"info"

Priority Rules

优先级规则

Priority	Rule	Impact	Tools
1	Run doctor to check dependencies	CRITICAL	`kubectl-mcp-server doctor`
2	Use tools -d for descriptions	HIGH	`kubectl-mcp-server tools -d`
3	Use grep for tool discovery	MEDIUM	`kubectl-mcp-server grep`
4	Use call for direct invocation	MEDIUM	`kubectl-mcp-server call`

优先级	规则	影响程度	工具
1	运行doctor检查依赖	关键	`kubectl-mcp-server doctor`
2	使用tools -d查看描述	高	`kubectl-mcp-server tools -d`
3	使用grep进行工具发现	中	`kubectl-mcp-server grep`
4	使用call进行直接调用	中	`kubectl-mcp-server call`

Quick Reference

速查指南

Task	Command	Example
List tools	`tools -d`	`kubectl-mcp-server tools -d`
Search tools	`grep`	`kubectl-mcp-server grep "pod"`
Call tool	`call`	`kubectl-mcp-server call get_pods '{"namespace": "default"}'`
Check health	`doctor`	`kubectl-mcp-server doctor`

任务	命令	示例
列出工具	`tools -d`	`kubectl-mcp-server tools -d`
搜索工具	`grep`	`kubectl-mcp-server grep "pod"`
调用工具	`call`	`kubectl-mcp-server call get_pods '{"namespace": "default"}'`
检查健康状态	`doctor`	`kubectl-mcp-server doctor`

Server Commands

服务器命令

Start Server

启动服务器

bash

undefined

bash

undefined

stdio transport (for Claude Desktop)

标准输入输出传输（适用于Claude Desktop）

kubectl-mcp-server serve

HTTP transport (for remote clients)

HTTP传输（适用于远程客户端）

kubectl-mcp-server serve --transport streamable-http --port 8000

With debug logging

启用调试日志

MCP_DEBUG=true kubectl-mcp-server serve

undefined

MCP_DEBUG=true kubectl-mcp-server serve

undefined

Check Health

检查健康状态

bash

undefined

bash

undefined

Verify dependencies

验证依赖

kubectl-mcp-server doctor

Shows:

输出示例：

✓ kubectl: found

✓ kubectl: 已找到

✓ helm: found

✓ helm: 已找到

✓ kubeconfig: valid

✓ kubeconfig: 有效

✓ cluster: connected

✓ cluster: 已连接

undefined

undefined

Tool Discovery

工具发现

List Tools

列出工具

bash

undefined

bash

undefined

List all tools

列出所有工具

kubectl-mcp-server tools

List with descriptions

列出工具及描述

kubectl-mcp-server tools -d

JSON output

JSON格式输出

kubectl-mcp-server tools --json

undefined

kubectl-mcp-server tools --json

undefined

Search Tools

搜索工具

bash

undefined

bash

undefined

Search by pattern

按模式搜索

kubectl-mcp-server grep "pod" kubectl-mcp-server grep "helm" kubectl-mcp-server grep "velero"

Results show matching tool names

结果显示匹配的工具名称

undefined

undefined

Tool Schema

工具架构

bash

undefined

bash

undefined

Show tool parameters

查看工具参数

kubectl-mcp-server tools get_pods kubectl-mcp-server tools install_helm_chart

Shows:

输出内容：

- Description

- 描述

- Parameters (name, type, required)

- 参数（名称、类型、是否必填）

- Return type

- 返回类型

undefined

undefined

Direct Tool Invocation

直接调用工具

Call Tools

调用工具

bash

undefined

bash

undefined

Call with JSON arguments

使用JSON参数调用

kubectl-mcp-server call get_pods '{"namespace": "default"}'

Call with stdin

通过标准输入调用

echo '{"namespace": "kube-system"}' | kubectl-mcp-server call get_pods

Call with no arguments

无参数调用

kubectl-mcp-server call get_namespaces '{}'

undefined

kubectl-mcp-server call get_namespaces '{}'

undefined

Examples

示例

bash

undefined

bash

undefined

Get pods

获取Pod

kubectl-mcp-server call get_pods '{"namespace": "default"}'

Describe pod

描述Pod

kubectl-mcp-server call describe_pod '{"name": "nginx-xxx", "namespace": "default"}'

Get logs

获取日志

kubectl-mcp-server call get_pod_logs '{"name": "nginx-xxx", "namespace": "default"}'

Scale deployment

扩缩容Deployment

kubectl-mcp-server call scale_deployment '{"name": "nginx", "namespace": "default", "replicas": 3}'

Install helm chart

安装Helm Chart

kubectl-mcp-server call install_helm_chart '{ "name": "my-release", "chart": "bitnami/nginx", "namespace": "default" }'

undefined

kubectl-mcp-server call install_helm_chart '{ "name": "my-release", "chart": "bitnami/nginx", "namespace": "default" }'

undefined

Context Management

上下文管理

bash

undefined

bash

undefined

Show current context

查看当前上下文

kubectl-mcp-server context

Switch context

切换上下文

kubectl-mcp-server context production

List available contexts

列出可用上下文

kubectl-mcp-server call list_contexts_tool '{}'

undefined

kubectl-mcp-server call list_contexts_tool '{}'

undefined

Server Info

服务器信息

bash

undefined

bash

undefined

Show server information

查看服务器信息

kubectl-mcp-server info

Shows:

输出内容：

- Version

- 版本

- Tool count

- 工具数量

- Resource count

- 资源数量

- Prompt count

- 提示词数量

undefined

undefined

MCP Resources

MCP资源

bash

undefined

bash

undefined

List available resources

列出可用资源

kubectl-mcp-server resources

Resources:

资源包括：

- cluster://status

- namespaces://list

- pods://{namespace}

- deployments://{namespace}

- services://{namespace}

- events://{namespace}

- nodes://list

- contexts://list

undefined

undefined

MCP Prompts

MCP提示词

bash

undefined

bash

undefined

List available prompts

列出可用提示词

kubectl-mcp-server prompts

Prompts:

提示词包括：

- troubleshoot-pod

- deploy-application

- security-audit

- cost-optimization

- incident-response

- helm-workflow

- gitops-sync

- multi-cluster-compare

undefined

undefined

Environment Variables

环境变量

bash

undefined

bash

undefined

Core

核心配置

export MCP_DEBUG=true # Enable debug logging export MCP_LOG_FILE=/var/log/mcp.log # Log to file export NO_COLOR=1 # Disable colors

export MCP_DEBUG=true # 启用调试日志 export MCP_LOG_FILE=/var/log/mcp.log # 日志输出到文件 export NO_COLOR=1 # 禁用颜色输出

Browser (optional)

浏览器（可选）

export MCP_BROWSER_ENABLED=true export MCP_BROWSER_PROVIDER=browserbase export BROWSERBASE_API_KEY=bb_...

undefined

export MCP_BROWSER_ENABLED=true export MCP_BROWSER_PROVIDER=browserbase export BROWSERBASE_API_KEY=bb_...

undefined

Claude Desktop Configuration

Claude Desktop配置

json

{
  "mcpServers": {
    "kubectl": {
      "command": "kubectl-mcp-server",
      "args": ["serve"]
    }
  }
}

json

{
  "mcpServers": {
    "kubectl": {
      "command": "kubectl-mcp-server",
      "args": ["serve"]
    }
  }
}

Shell Aliases

Shell别名

bash

undefined

bash

undefined

Add to ~/.bashrc or ~/.zshrc

添加到~/.bashrc或~/.zshrc

alias kmcp='kubectl-mcp-server' alias kmcp-tools='kubectl-mcp-server tools -d' alias kmcp-call='kubectl-mcp-server call' alias kmcp-grep='kubectl-mcp-server grep'

undefined

alias kmcp='kubectl-mcp-server' alias kmcp-tools='kubectl-mcp-server tools -d' alias kmcp-call='kubectl-mcp-server call' alias kmcp-grep='kubectl-mcp-server grep'

undefined

k8s-cli

Original

Translation

kubectl-mcp-server CLI

kubectl-mcp-server CLI

When to Apply

适用场景

Priority Rules

优先级规则

Quick Reference

速查指南

Server Commands

服务器命令

Start Server

启动服务器

stdio transport (for Claude Desktop)

标准输入输出传输（适用于Claude Desktop）

HTTP transport (for remote clients)

HTTP传输（适用于远程客户端）

With debug logging

启用调试日志

Check Health

检查健康状态

Verify dependencies

验证依赖

Shows:

输出示例：

✓ kubectl: found

✓ kubectl: 已找到

✓ helm: found

✓ helm: 已找到

✓ kubeconfig: valid

✓ kubeconfig: 有效

✓ cluster: connected

✓ cluster: 已连接

Tool Discovery

工具发现

List Tools

列出工具

List all tools

列出所有工具

List with descriptions

列出工具及描述

JSON output

JSON格式输出

Search Tools

搜索工具

Search by pattern

按模式搜索

Results show matching tool names

结果显示匹配的工具名称

Tool Schema

工具架构

Show tool parameters

查看工具参数

Shows:

输出内容：

- Description

- 描述

- Parameters (name, type, required)

- 参数（名称、类型、是否必填）

- Return type

- 返回类型

Direct Tool Invocation

直接调用工具

Call Tools

调用工具

Call with JSON arguments

使用JSON参数调用

Call with stdin

通过标准输入调用

Call with no arguments

无参数调用

Examples

示例

Get pods

获取Pod

Describe pod

描述Pod

Get logs