destroy_terraform_service

Remove a Terraform-managed service and delete all associated resources from your homelab infrastructure.

Instructions

Destroy a Terraform-managed service and clean up all resources

Input Schema

TableJSON Schema

Name	Required	Description	Default
`service_name`	Yes	Name of the service to destroy
`hostname`	Yes	Hostname or IP address of the device
`username`	No	SSH username (use 'mcp_admin' for passwordless access after setup)	mcp_admin
`password`	No	SSH password (not needed for mcp_admin after setup)
`port`	No	SSH port (default: 22)

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,
```

Homelab MCP Server