GCP MCP

Instructions

    Delete a 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 delete
    
    Returns:
        Status message indicating whether the instance was deleted successfully
    

Implementation Reference

• src/gcp_mcp/gcp_modules/compute/tools.py:536-573 (handler)

  The delete_instance tool handler, registered via @mcp.tool() decorator, implements deletion of a GCP Compute Engine instance by calling the delete method on InstancesClient and polling the operation status.

  @mcp.tool()
  def delete_instance(project_id: str, zone: str, instance_name: str) -> str:
      """
      Delete a 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 delete
      
      Returns:
          Status message indicating whether the instance was deleted successfully
      """
      try:
          from google.cloud import compute_v1
          
          # Initialize the Compute Engine client
          client = compute_v1.InstancesClient()
          
          # Delete the instance
          operation = client.delete(project=project_id, zone=zone, instance=instance_name)
          
          # Wait for the operation to complete
          operation_client = compute_v1.ZoneOperationsClient()
          
          # This is a synchronous call that will wait until the operation is complete
          while operation.status != compute_v1.Operation.Status.DONE:
              operation = operation_client.get(project=project_id, zone=zone, operation=operation.name.split('/')[-1])
              import time
              time.sleep(1)
          
          if operation.error:
              return f"Error deleting instance {instance_name}: {operation.error.errors[0].message}"
          
          return f"Instance {instance_name} in zone {zone} deleted successfully."
      except Exception as e:
          return f"Error deleting instance: {str(e)}"

• src/gcp_mcp/gcp_modules/compute/tools.py:6-7 (registration)

  The register_tools function where all compute tools, including delete_instance, are registered using @mcp.tool() decorators.

  def register_tools(mcp):
      """Register all compute tools with the MCP server."""