k8s-pilot

Instructions

Implementation Reference

• tools/node.py:447-479 (handler)

  The handler function that retrieves all pods running on the specified node using the Kubernetes CoreV1Api. It lists pods across all namespaces with field_selector spec.nodeName matching the node_name, formats pod info, and returns JSON.

  def get_node_pods(context_name: str, node_name: str):
      """
      Get all pods running on a specific node.
  
      Args:
          context_name: The Kubernetes context name
          node_name: The name of the node to get pods for
  
      Returns:
          JSON string containing the pods running on the node
      """
      core_v1: CoreV1Api = get_api_clients(context_name)["core"]
  
      # Get all pods in all namespaces
      pods = core_v1.list_pod_for_all_namespaces(field_selector=f"spec.nodeName={node_name}")
  
      pod_list = [
          {
              "name": pod.metadata.name,
              "namespace": pod.metadata.namespace,
              "status": pod.status.phase,
              "containers": [c.name for c in pod.spec.containers]
          } for pod in pods.items
      ]
  
      result = {
          "node": node_name,
          "pods": pod_list,
          "pod_count": len(pod_list)
      }
  
      return json.dumps(result)

• tools/node.py:445-446 (registration)

  The @mcp.tool() decorator registers the get_node_pods function as an MCP tool. The @use_current_context decorator provides the current Kubernetes context.

  @mcp.tool()
  @use_current_context