请参阅我们的 用户文档 中的 Claude Code 入门指南。

对于具有专用 ServiceAccount 和只读权限的安全生产环境，请同时查阅 Kubernetes 设置指南。

• configuration_contexts_list - 列出 kubeconfig 文件中所有可用的上下文名称及其关联的服务器 URL

• targets_list - 列出所有可用的目标

• configuration_view - 获取当前 Kubernetes 配置内容，以 kubeconfig YAML 格式呈现

  • minified (boolean) - 返回配置的精简版本。若设置为 true，则仅保留当前上下文以及该上下文相关的部分；若设置为 false，则返回配置中的所有上下文、集群、认证信息和用户。（可选，默认为 true）

• events_list - 列出当前集群中所有命名空间的 Kubernetes 事件（警告、错误、状态变化），用于调试和故障排除

  • namespace (string) - 指定要检索事件的命名空间。若未提供，则列出所有命名空间的事件

• namespaces_list - 列出当前集群中的所有 Kubernetes 命名空间

• projects_list - 列出当前集群中的所有 OpenShift 项目

• nodes_log - 从 Kubernetes 节点获取日志（kubelet、kube-proxy 或其他系统日志）。此操作通过 Kubernetes API 代理访问节点上的 kubelet 日志

  • name (string) (必需) - 要获取日志的节点名称
  • query (string) (必需) - 指定要返回日志的服务或文件。（必填）例如：“kubelet”用于获取 kubelet 日志，“/<日志文件名>”用于获取节点上的特定日志文件（如“/var/log/kubelet.log”或“/var/log/kube-proxy.log”）
  • tailLines (integer) - 从日志末尾提取的行数。（可选，默认为 0，表示返回全部日志）

• nodes_stats_summary - 通过 kubelet 的 Summary API 获取 Kubernetes 节点的详细资源使用情况统计信息。提供包括 CPU、内存、文件系统和网络使用在内的全面指标，涵盖节点、Pod 和容器级别。在使用 cgroup v2 和内核 4.20+ 的系统上，还会包含 PSI（压力停滞信息）指标，显示 CPU、内存和 I/O 方面的资源压力。有关 PSI 指标的详细信息，请参阅 https://kubernetes.io/docs/reference/instrumentation/understand-psi-metrics/

  • name (string) (必需) - 要获取统计数据的节点名称

• nodes_top - 列出由 Kubernetes Metrics Server 记录的指定 Kubernetes 节点或集群中所有节点的资源消耗情况（CPU 和内存）

  • label_selector (string) - Kubernetes 标签选择器（如 ‘node-role.kubernetes.io/worker=’），用于按标签筛选节点。（可选，仅在未提供节点名称时适用）
  • name (string) - 要获取资源消耗信息的节点名称。（可选，若未提供则列出所有节点）

• pods_list - 列出当前集群中所有命名空间内的 Kubernetes Pod

  • fieldSelector (string) - 可选的 Kubernetes 字段选择器，用于按字段值过滤 Pod（如 ‘status.phase=Running’、‘spec.nodeName=node1’）。支持的字段包括：metadata.name、metadata.namespace、spec.nodeName、spec.restartPolicy、spec.schedulerName、spec.serviceAccountName、status.phase（Pending/Running/Succeeded/Failed/Unknown）、status.podIP、status.nominatedNodeName。请注意，CrashLoopBackOff 是容器状态，而非 Pod 阶段，因此无法直接通过状态进行过滤。更多信息请参阅 https://kubernetes.io/docs/concepts/overview/working-with-objects/field-selectors/
  • labelSelector (string) - 可选的 Kubernetes 标签选择器（如 ‘app=myapp,env=prod’ 或 ‘app in (myapp,yourapp)’），当需要按标签筛选 Pod 时使用此选项
  • namespace (string) (必需) - 要列出 Pod 的命名空间

• pods_get - 获取当前或指定命名空间中具有指定名称的 Kubernetes Pod

  • name（string）（必填） - Pod 的名称
  • namespace（string）- 用于获取 Pod 的命名空间

• pods_delete - 删除当前或指定命名空间中具有指定名称的 Kubernetes Pod

  • name（string）（必填） - 要删除的 Pod 名称
  • namespace（string）- 用于删除 Pod 的命名空间

• pods_top - 列出由 Kubernetes Metrics Server 记录的指定 Kubernetes Pod 在所有命名空间、指定命名空间或当前命名空间中的资源消耗情况（CPU 和内存）

  • all_namespaces（boolean）- 如果为真，则列出所有命名空间中所有 Pod 的资源消耗；如果为假，则列出指定命名空间或当前命名空间中 Pod 的资源消耗
  • label_selector（string）- Kubernetes 标签选择器（例如 'app=myapp,env=prod' 或 'app in (myapp,yourapp)'），当您希望按标签筛选 Pod 时使用此选项（可选，仅在未提供 name 时适用）
  • name（string）- 要获取资源消耗的 Pod 名称（可选，未提供时为命名空间中的所有 Pod）
  • namespace（string）- 用于获取 Pod 资源消耗的命名空间（可选，未提供且 all_namespaces 为假时为当前命名空间）

• pods_exec - 在当前或指定命名空间中，对具有指定名称和命令的 Kubernetes Pod 执行命令（Shell 访问，在容器中运行命令）

  • command（array）（必填） - 在 Pod 容器中执行的命令。第一个元素是要运行的命令，其余为该命令的参数。示例：["ls", "-l", "/tmp"]
  • container（string）- 将要执行命令的 Pod 容器名称（可选）
  • name（string）（必填） - 将要执行命令的 Pod 名称
  • namespace（string）- 将要执行命令的 Pod 所在的命名空间

• pods_log - 获取当前或指定命名空间中具有指定名称的 Kubernetes Pod 的日志

  • container（string）- 要获取日志的 Pod 容器名称（可选）
  • name（string）（必填） - 要获取日志的 Pod 名称
  • namespace（string）- 用于获取 Pod 日志的命名空间
  • previous（boolean）- 返回之前终止的容器日志（可选）
  • tail（integer）- 从日志末尾获取的行数（可选，默认：100）

• pods_run - 在当前或指定命名空间中，使用提供的容器镜像并可选地指定名称来运行 Kubernetes Pod

  • image（string）（必填） - 在 Pod 中运行的容器镜像
  • name（string）- Pod 的名称（可选，未提供时随机生成）
  • namespace（string）- 运行 Pod 的命名空间
  • port（number）- 从 Pod 容器暴露的 TCP/IP 端口（可选，未提供时不暴露端口）

• resources_list - 通过提供资源的 apiVersion 和 kind，并可选地提供命名空间和标签选择器，列出当前集群中的 Kubernetes 资源和对象 （常见的 apiVersion 和 kind 包括：v1 Pod、v1 Service、v1 Node、apps/v1 Deployment、networking.k8s.io/v1 Ingress、route.openshift.io/v1 Route）

  • apiVersion（string）（必填） - 资源的 apiVersion（有效值示例：v1、apps/v1、networking.k8s.io/v1）
  • fieldSelector（string）- 可选的 Kubernetes 字段选择器，用于按字段值筛选资源（例如 'status.phase=Running'、'metadata.name=myresource'）。支持的字段因资源类型而异。对于 Pod：metadata.name、metadata.namespace、spec.nodeName、spec.restartPolicy、spec.schedulerName、spec.serviceAccountName、status.phase（Pending/Running/Succeeded/Failed/Unknown）、status.podIP、status.nominatedNodeName。更多信息请参见：https://kubernetes.io/docs/concepts/overview/working-with-objects/field-selectors/
  • kind（string）（必填） - 资源的种类（有效值示例：Pod、Service、Deployment、Ingress）
  • labelSelector（string）- 可选的 Kubernetes 标签选择器（例如 'app=myapp,env=prod' 或 'app in (myapp,yourapp)'），当您希望按标签筛选资源时使用此选项
  • namespace（string）- 可选的命名空间，用于检索命名空间范围内的资源（对于集群范围的资源则忽略）。未提供时将列出所有命名空间中的资源

• resources_get - 通过提供资源的 apiVersion、kind、可选的命名空间以及名称，获取当前集群中的 Kubernetes 资源 （常见的 apiVersion 和 kind 包括：v1 Pod、v1 Service、v1 Node、apps/v1 Deployment、networking.k8s.io/v1 Ingress、route.openshift.io/v1 Route）

  • apiVersion（string）（必填） - 资源的 apiVersion（有效值示例：v1、apps/v1、networking.k8s.io/v1）
  • kind（string）（必填） - 资源的种类（有效值示例：Pod、Service、Deployment、Ingress）
  • name（string）（必填） - 资源的名称
  • namespace（string）- 可选的命名空间，用于检索命名空间范围的资源（对于集群范围的资源则忽略）。未提供时将从配置的命名空间获取资源

• resources_create_or_update - 通过提供资源的 YAML 或 JSON 表示形式，在当前集群中创建或更新 Kubernetes 资源 （常见的 apiVersion 和 kind 包括：v1 Pod、v1 Service、v1 Node、apps/v1 Deployment、networking.k8s.io/v1 Ingress、route.openshift.io/v1 Route）

  • resource（string）（必填） - 包含 Kubernetes 资源表示的 JSON 或 YAML 文件。应包含顶级字段，如 apiVersion、kind、metadata 和 spec

• resources_delete - 通过提供资源的 apiVersion、kind、可选的命名空间以及名称，删除当前集群中的 Kubernetes 资源 （常见的 apiVersion 和 kind 包括：v1 Pod、v1 Service、v1 Node、apps/v1 Deployment、networking.k8s.io/v1 Ingress、route.openshift.io/v1 Route）

  • apiVersion（string）（必填） - 资源的 apiVersion（有效值示例：v1、apps/v1、networking.k8s.io/v1）
  • gracePeriodSeconds（integer）- 对象被删除前的可选宽限期（以秒为单位）。值必须是非负整数。值为零表示立即删除。如果未指定此值，则将使用指定类型的默认宽限期
  • kind（string）（必填） - 资源的种类（有效值示例：Pod、Service、Deployment、Ingress）
  • name（string）（必填） - 资源的名称
  • namespace（string）- 可选的命名空间，用于删除命名空间范围的资源（对于集群范围的资源则忽略）。未提供时将从配置的命名空间删除资源

• resources_scale - 通过提供 Kubernetes 资源的 apiVersion、kind 和名称，以及可选的命名空间，在当前集群中获取或更新该资源的规模。如果在工具调用中指定了 scale 值，则会将规模更新为该值。始终返回资源的当前规模。

  • apiVersion（string）（必填） - 资源的 API 版本（有效示例：apps/v1）
  • kind（string）（必填） - 资源的类型（有效示例：StatefulSet、Deployment）
  • name（string）（必填） - 资源的名称
  • namespace（string）- 可选的命名空间，用于获取或更新命名空间范围内的资源规模（对于集群范围的资源则忽略）。如果不提供，则将在配置的命名空间中获取或更新资源规模。
  • scale（integer）- 可选的规模值，用于将资源规模更新为此值。如果不提供，则返回资源的当前规模，而不进行更新。

• helm_install - 安装（部署）一个 Helm Chart，在当前或指定的命名空间中创建一个发布版本。

  • chart（string）（必填） - 要安装的 Chart 引用（例如：stable/grafana、oci://ghcr.io/nginxinc/charts/nginx-ingress）
  • name（string）- Helm 发布的名称（可选，未提供时随机生成）
  • namespace（string）- 安装 Helm Chart 的命名空间（可选，未提供时使用当前命名空间）
  • values（object）- 传递给 Helm Chart 的值（可选）

• helm_list - 列出当前或指定命名空间中的所有 Helm 发布版本（或列出所有命名空间中的发布版本，如果已指定）。

  • all_namespaces（boolean）- 如果为真，则列出所有命名空间中的 Helm 发布版本，忽略 namespace 参数（可选）
  • namespace（string）- 要列出 Helm 发布版本的命名空间（可选，未提供时列出所有命名空间）

• helm_uninstall - 卸载当前或指定命名空间中的 Helm 发布版本。

  • name（string）（必填） - 要卸载的 Helm 发布版本的名称
  • namespace（string）- 卸载 Helm 发布版本的命名空间（可选，未提供时使用当前命名空间）

• kcp_workspaces_list - 列出当前集群中所有可用的 kcp 工作空间。

• kcp_workspace_describe - 获取特定 kcp 工作空间的详细信息。

  • workspace（string）（必填） - 要描述的工作空间的名称或路径。

• kiali_mesh_graph - 返回特定命名空间的拓扑结构、网格健康状况及命名空间状态。包含网格健康概览，汇总显示正常、降级和故障的应用、工作负载和服务数量。适用于高层次的概览。

  • graphType（string）- 可选的图表类型：'versionedApp'、'app'、'service'、'workload'、'mesh'
  • namespace（string）- 可选的单个命名空间，用于包含在图表中（替代 namespaces 参数）
  • namespaces（string）- 可选的逗号分隔的命名空间列表，用于包含在图表中
  • rateInterval（string）- 可选的采集速率间隔（例如：'10m'、'5m'、'1h'）。

• kiali_manage_istio_config_read - 列出或获取 Istio 配置对象（网关、虚拟服务等）。

  • action（string）（必填） - 要执行的操作：列出或获取
  • group（string）- Istio 对象的 API 组（例如：'networking.istio.io'、'gateway.networking.k8s.io'）
  • kind（string）- Istio 对象的类型（例如：'DestinationRule'、'VirtualService'、'HTTPRoute'、'Gateway'）
  • name（string）- Istio 对象的名称
  • namespace（string）- 包含 Istio 对象的命名空间
  • version（string）- Istio 对象的 API 版本（例如：'v1'、'v1beta1'）

• kiali_manage_istio_config - 创建、修补或删除 Istio 配置对象（网关、虚拟服务等）。

  • action（string）（必填） - 要执行的操作：创建、修补或删除
  • group（string）- Istio 对象的 API 组（例如：'networking.istio.io'、'gateway.networking.k8s.io'）
  • json_data（string）- 用于应用或创建对象的 JSON 数据
  • kind（string）- Istio 对象的类型（例如：'DestinationRule'、'VirtualService'、'HTTPRoute'、'Gateway'）
  • name（string）- Istio 对象的名称
  • namespace（string）- 包含 Istio 对象的命名空间
  • version（string）- Istio 对象的 API 版本（例如：'v1'、'v1beta1'）

• kiali_get_resource_details - 获取网格内 Kubernetes 资源（服务、工作负载）的列表或详细信息。

  • namespaces（string）- 用于获取服务的逗号分隔的命名空间列表（例如：'bookinfo' 或 'bookinfo,default'）。如果未提供，则会列出所有可访问命名空间中的服务。
  • resource_name（string）- 要获取详细信息的资源名称（可选字符串：如果提供则获取详细信息；若为空则列出所有）。
  • resource_type（string）- 要获取详细信息的资源类型（服务、工作负载）。

• kiali_get_metrics - 获取网格内 Kubernetes 资源（服务、工作负载）的列表或详细信息。

  • byLabels（string）- 用于对指标进行分组的逗号分隔标签列表（例如：'source_workload,destination_service'）。可选
  • direction（string）- 流量方向：'inbound' 或 'outbound'。可选，默认为 'outbound'
  • namespace（string）（必填） - 要获取资源的命名空间
  • quantiles（string）- 用于直方图指标的逗号分隔的分位数列表（例如：'0.5,0.95,0.99'）。可选
  • rateInterval（string）- 指标的采集间隔（例如：'1m'、'5m'）。可选，默认为 '10m'
  • reporter（string）- 指标报告者：'source'、'destination' 或 'both'。可选，默认为 'source'
  • requestProtocol（string）- 按请求协议过滤（例如：'http'、'grpc'、'tcp'）。可选
  • resource_name（string）（必填） - 要获取详细信息的资源名称（可选字符串：如果提供则获取详细信息；若为空则列出所有）。
  • resource_type（string）（必填） - 要获取详细信息的资源类型（服务、工作负载）
  • step（string）- 数据点之间的步长（以秒为单位，例如：'15'）。可选，默认为 15 秒

• kiali_workload_logs - Get logs for a specific workload's pods in a namespace. Only requires namespace and workload name - automatically discovers pods and containers. Optionally filter by container name, time range, and other parameters. Container is auto-detected if not specified.

  • container (string) - Optional container name to filter logs. If not provided, automatically detects and uses the main application container (excludes istio-proxy and istio-init)
  • namespace (string) (required) - Namespace containing the workload
  • since (string) - Time duration to fetch logs from (e.g., '5m', '1h', '30s'). If not provided, returns recent logs
  • tail (integer) - Number of lines to retrieve from the end of logs (default: 100)
  • workload (string) (required) - Name of the workload to get logs for

• kiali_get_traces - Gets traces for a specific resource (app, service, workload) in a namespace, or gets detailed information for a specific trace by its ID. If traceId is provided, it returns detailed trace information and other parameters are not required.

  • clusterName (string) - Cluster name for multi-cluster environments (optional, only used when traceId is not provided)
  • endMicros (string) - End time for traces in microseconds since epoch (optional, defaults to 10 minutes after startMicros if not provided, only used when traceId is not provided)
  • limit (integer) - Maximum number of traces to return (default: 100, only used when traceId is not provided)
  • minDuration (integer) - Minimum trace duration in microseconds (optional, only used when traceId is not provided)
  • namespace (string) - Namespace to get resources from. Required if traceId is not provided.
  • resource_name (string) - Name of the resource to get traces for. Required if traceId is not provided.
  • resource_type (string) - Type of resource to get traces for (app, service, workload). Required if traceId is not provided.
  • startMicros (string) - Start time for traces in microseconds since epoch (optional, defaults to 10 minutes before current time if not provided, only used when traceId is not provided)
  • tags (string) - JSON string of tags to filter traces (optional, only used when traceId is not provided)
  • traceId (string) - Unique identifier of the trace to retrieve detailed information for. If provided, this will return detailed trace information and other parameters (resource_type, namespace, resource_name) are not required.

• vm_clone - Clone a KubeVirt VirtualMachine by creating a VirtualMachineClone resource. This creates a copy of the source VM with a new name using the KubeVirt Clone API

  • name (string) (required) - The name of the source virtual machine to clone
  • namespace (string) (required) - The namespace of the source virtual machine
  • targetName (string) (required) - The name for the new cloned virtual machine

• vm_create - Create a VirtualMachine in the cluster with the specified configuration, automatically resolving instance types, preferences, and container disk images. VM will be created in Halted state by default; use autostart parameter to start it immediately.

  • autostart (boolean) - Optional flag to automatically start the VM after creation (sets runStrategy to Always instead of Halted). Defaults to false.
  • instancetype (string) - Optional instance type name for the VM (e.g., 'u1.small', 'u1.medium', 'u1.large')
  • name (string) (required) - The name of the virtual machine
  • namespace (string) (required) - The namespace for the virtual machine
  • networks (array) - Optional secondary network interfaces to attach to the VM. Each item specifies a Multus NetworkAttachmentDefinition to attach. Accepts either simple strings (NetworkAttachmentDefinition names) or objects with 'name' (interface name in VM) and 'networkName' (NetworkAttachmentDefinition name) properties. Each network creates a bridge interface on the VM.
  • performance (string) - Optional performance family hint for the VM instance type (e.g., 'u1' for general-purpose, 'o1' for overcommitted, 'c1' for compute-optimized, 'm1' for memory-optimized). Defaults to 'u1' (general-purpose) if not specified.
  • preference (string) - Optional preference name for the VM
  • size (string) - Optional workload size hint for the VM (e.g., 'small', 'medium', 'large', 'xlarge'). Used to auto-select an appropriate instance type if not explicitly specified.
  • storage (string) - Optional storage size for the VM's root disk when using DataSources (e.g., '30Gi', '50Gi', '100Gi'). Defaults to 30Gi. Ignored when using container disks.
  • workload (string) - The workload for the VM. Accepts OS names (e.g., 'fedora' (default), 'ubuntu', 'centos', 'centos-stream', 'debian', 'rhel', 'opensuse', 'opensuse-tumbleweed', 'opensuse-leap') or full container disk image URLs

• vm_lifecycle - Manage VirtualMachine lifecycle: start, stop, or restart a VM

  • action (string) (required) - The lifecycle action to perform: 'start' (changes runStrategy to Always), 'stop' (changes runStrategy to Halted), or 'restart' (stops then starts the VM)
  • name (string) (required) - The name of the virtual machine
  • namespace (string) (required) - The namespace of the virtual machine

• tekton_pipeline_start - Start a Tekton Pipeline by creating a PipelineRun that references it

  • name (string) (required) - Name of the Pipeline to start
  • namespace (string) - Namespace of the Pipeline
  • params (object) - Parameter values to pass to the Pipeline. Keys are parameter names; values can be a string, an array of strings, or an object (map of string to string) depending on the parameter type defined in the Pipeline spec

• tekton_pipelinerun_restart - Restart a Tekton PipelineRun by creating a new PipelineRun with the same spec

  • name (string) (required) - Name of the PipelineRun to restart
  • namespace (string) - Namespace of the PipelineRun

• tekton_task_start - Start a Tekton Task by creating a TaskRun that references it

  • name (string) (required) - Name of the Task to start
  • namespace (string) - Namespace of the Task
  • params (object) - Parameter values to pass to the Task. Keys are parameter names; values can be a string, an array of strings, or an object (map of string to string) depending on the parameter type defined in the Task spec

• tekton_taskrun_restart - Restart a Tekton TaskRun by creating a new TaskRun with the same spec

  • name (string) (required) - Name of the TaskRun to restart
  • namespace (string) - Namespace of the TaskRun

• tekton_taskrun_logs - Get the logs from a Tekton TaskRun by resolving its underlying pod

  • name (string) (required) - Name of the TaskRun to get logs from
  • namespace (string) - Namespace of the TaskRun
  • tail (integer) - Number of lines to retrieve from the end of the logs (Optional, default: 100)

• cluster-health-check - Perform comprehensive health assessment of Kubernetes/OpenShift cluster
  • namespace (string) - Optional namespace to limit health check scope (default: all namespaces)
  • check_events (string) - Include recent warning/error events (true/false, default: true)

• vm-troubleshoot - Generate a step-by-step troubleshooting guide for diagnosing VirtualMachine issues
  • namespace (string) (required) - The namespace of the VirtualMachine to troubleshoot
  • name (string) (required) - The name of the VirtualMachine to troubleshoot