get_instance_details

Instructions

    Get detailed information about a specific Compute Engine instance.
    
    Args:
        project_id: The ID of the GCP project
        zone: The zone where the instance is located (e.g., "us-central1-a")
        instance_name: The name of the instance to get details for
    
    Returns:
        Detailed information about the specified Compute Engine instance
    

Implementation Reference

• src/gcp_mcp/gcp_modules/compute/tools.py:96-204 (handler)

  The handler function decorated with @mcp.tool() that implements the core logic for retrieving and formatting detailed information about a GCP Compute Engine instance using the google-cloud-compute library.

      @mcp.tool()
      def get_instance_details(project_id: str, zone: str, instance_name: str) -> str:
          """
          Get detailed information about a specific Compute Engine instance.
          
          Args:
              project_id: The ID of the GCP project
              zone: The zone where the instance is located (e.g., "us-central1-a")
              instance_name: The name of the instance to get details for
          
          Returns:
              Detailed information about the specified Compute Engine instance
          """
          try:
              from google.cloud import compute_v1
              
              # Initialize the Compute Engine client
              client = compute_v1.InstancesClient()
              
              # Get the instance details
              instance = client.get(project=project_id, zone=zone, instance=instance_name)
              
              # Format machine type
              machine_type = instance.machine_type.split('/')[-1] if instance.machine_type else "Unknown"
              
              # Format creation timestamp
              creation_timestamp = instance.creation_timestamp if instance.creation_timestamp else "Unknown"
              
              # Format boot disk
              boot_disk = "None"
              if instance.disks:
                  for disk in instance.disks:
                      if disk.boot:
                          boot_disk = disk.source.split('/')[-1] if disk.source else "Unknown"
                          break
              
              # Get IP addresses
              network_interfaces = []
              if instance.network_interfaces:
                  for i, iface in enumerate(instance.network_interfaces):
                      network = iface.network.split('/')[-1] if iface.network else "Unknown"
                      subnetwork = iface.subnetwork.split('/')[-1] if iface.subnetwork else "Unknown"
                      internal_ip = iface.network_i_p or "None"
                      
                      # Check for external IP
                      external_ip = "None"
                      if iface.access_configs:
                          external_ip = iface.access_configs[0].nat_i_p or "None"
                      
                      network_interfaces.append(f"  Interface {i}:\n    Network: {network}\n    Subnetwork: {subnetwork}\n    Internal IP: {internal_ip}\n    External IP: {external_ip}")
              
              networks_str = "\n".join(network_interfaces) if network_interfaces else "  None"
              
              # Get attached disks
              disks = []
              if instance.disks:
                  for i, disk in enumerate(instance.disks):
                      disk_name = disk.source.split('/')[-1] if disk.source else "Unknown"
                      disk_type = "Boot" if disk.boot else "Data"
                      auto_delete = "Yes" if disk.auto_delete else "No"
                      mode = disk.mode if disk.mode else "Unknown"
                      
                      disks.append(f"  Disk {i}:\n    Name: {disk_name}\n    Type: {disk_type}\n    Mode: {mode}\n    Auto-delete: {auto_delete}")
              
              disks_str = "\n".join(disks) if disks else "  None"
              
              # Get labels
              labels = []
              if instance.labels:
                  for key, value in instance.labels.items():
                      labels.append(f"  {key}: {value}")
              
              labels_str = "\n".join(labels) if labels else "  None"
              
              # Get metadata
              metadata_items = []
              if instance.metadata and instance.metadata.items:
                  for item in instance.metadata.items:
                      metadata_items.append(f"  {item.key}: {item.value}")
              
              metadata_str = "\n".join(metadata_items) if metadata_items else "  None"
              
              return f"""
  Compute Engine Instance Details for {instance_name}:
  
  Project: {project_id}
  Zone: {zone}
  Machine Type: {machine_type}
  Status: {instance.status}
  Creation Time: {creation_timestamp}
  CPU Platform: {instance.cpu_platform}
  Boot Disk: {boot_disk}
  
  Network Interfaces:
  {networks_str}
  
  Disks:
  {disks_str}
  
  Labels:
  {labels_str}
  
  Metadata:
  {metadata_str}
  
  Service Accounts: {"Yes" if instance.service_accounts else "None"}
  """
          except Exception as e:
              return f"Error getting instance details: {str(e)}"