destroy_terraform_service

Instructions

Implementation Reference

• src/homelab_mcp/tool_handlers/service_handlers.py:64-68 (handler)

  MCP tool handler function that wraps the destroy_terraform_service method. Creates a ServiceInstaller instance and delegates to the destroy_terraform_service method with the provided arguments, returning the result as JSON-formatted text.

  async def handle_destroy_terraform_service(arguments: dict[str, Any]) -> dict[str, Any]:
      """Handle destroy_terraform_service tool."""
      installer = ServiceInstaller()
      destroy_result = await installer.destroy_terraform_service(**arguments)
      return {"content": [{"type": "text", "text": json.dumps(destroy_result, indent=2)}]}

• src/homelab_mcp/service_installer.py:930-980 (handler)

  Core implementation of destroy_terraform_service method. Checks if the Terraform directory exists at /opt/terraform/{service_name}, runs 'terraform destroy -auto-approve', and cleans up the directory if destroy succeeds. Returns status, service name, action, and output.

  async def destroy_terraform_service(
      self,
      service_name: str,
      hostname: str,
      username: str = "mcp_admin",
      password: str | None = None,
  ) -> dict[str, Any]:
      """Destroy a Terraform-managed service."""
      tf_dir = f"/opt/terraform/{service_name}"
  
      # Check if Terraform directory exists
      dir_check = await ssh_execute_command(
          hostname=hostname,
          username=username,
          password=password,
          command=f"test -d {tf_dir}",
      )
  
      dir_data = json.loads(dir_check)
      if dir_data.get("exit_code") != 0:
          return {
              "status": "error",
              "error": f"Terraform directory not found: {tf_dir}",
          }
  
      # Run terraform destroy
      destroy_result = await ssh_execute_command(
          hostname=hostname,
          username=username,
          password=password,
          command=f"cd {tf_dir} && terraform destroy -auto-approve",
      )
  
      destroy_data = json.loads(destroy_result)
  
      # Clean up Terraform directory if destroy succeeded
      if destroy_data.get("exit_code") == 0:
          await ssh_execute_command(
              hostname=hostname,
              username=username,
              password=password,
              command=f"sudo rm -rf {tf_dir}",
              sudo=True,
          )
  
      return {
          "status": "success" if destroy_data.get("exit_code") == 0 else "error",
          "service": service_name,
          "action": "destroy",
          "output": destroy_data.get("output", ""),
      }

• src/homelab_mcp/tool_schemas/service_tools_schema.py:155-185 (schema)

  Input schema definition for destroy_terraform_service tool. Defines required parameters (service_name, hostname) and optional parameters (username with default 'mcp_admin', password, port with default 22). Describes the tool's purpose as destroying a Terraform-managed service and cleaning up all resources.

  "destroy_terraform_service": {
      "description": "Destroy a Terraform-managed service and clean up all resources",
      "inputSchema": {
          "type": "object",
          "properties": {
              "service_name": {
                  "type": "string",
                  "description": "Name of the service to destroy",
              },
              "hostname": {
                  "type": "string",
                  "description": "Hostname or IP address of the device",
              },
              "username": {
                  "type": "string",
                  "description": "SSH username (use 'mcp_admin' for passwordless access after setup)",
                  "default": "mcp_admin",
              },
              "password": {
                  "type": "string",
                  "description": "SSH password (not needed for mcp_admin after setup)",
              },
              "port": {
                  "type": "integer",
                  "description": "SSH port (default: 22)",
                  "default": 22,
              },
          },
          "required": ["service_name", "hostname"],
      },
  },

• src/homelab_mcp/tool_handlers/__init__.py:44-44 (registration)

  Import statement for handle_destroy_terraform_service handler function from service_handlers module.

  handle_destroy_terraform_service,

• src/homelab_mcp/tool_handlers/__init__.py:111-111 (registration)

  Tool registration mapping the tool name 'destroy_terraform_service' to its handler function in the TOOL_HANDLERS dictionary.

  "destroy_terraform_service": handle_destroy_terraform_service,