Kubernetes MCP Server

Instructions

Implementation Reference

• server.js:1528-1536 (handler)

  Handler that runs `kubectl describe pod <pod> [-n <namespace>]` to retrieve detailed pod information and returns the output.

  case "describe-pod": {
    const { pod, namespace } = args;
    const nsArg = namespace ? `-n ${namespace}` : "";
    const cmd = `kubectl describe pod ${pod} ${nsArg}`;
    const { stdout } = await execAsync(cmd);
    return {
      content: [{ type: "text", text: stdout || "No pod details found" }]
    };
  }

• server.js:178-194 (schema)

  Tool schema defining input parameters: required 'pod' name and optional 'namespace'.

    name: "describe-pod",
    description: "Describe details of a Kubernetes pod",
    inputSchema: {
      type: "object",
      properties: {
        pod: { 
          type: "string",
          description: "The name of the pod to describe"
        },
        namespace: { 
          type: "string",
          description: "The namespace of the pod (optional, defaults to current context namespace)"
        }
      },
      required: ["pod"]
    }
  },

• server.js:1392-1394 (registration)

  Registration of all tools list including 'describe-pod' via ListToolsRequestSchema handler, which returns the static tools array.

  server.setRequestHandler(ListToolsRequestSchema, async () => {
    return { tools };
  });