Hetzner Cloud MCP Server

Instructions

Implementation Reference

• mcp_hetzner/server.py:629-646 (handler)

  The main handler function for the 'list_firewalls' tool. It retrieves all firewalls using the Hetzner Cloud client and formats the output using the firewall_to_dict helper.
  @mcp.tool() def list_firewalls() -> Dict[str, Any]: """ List all firewalls in your Hetzner Cloud account. Returns a list of all firewall instances with their details. Example: - Basic list: list_firewalls() """ try: firewalls = client.firewalls.get_all() return { "firewalls": [firewall_to_dict(firewall) for firewall in firewalls] } except Exception as e: return {"error": f"Failed to list firewalls: {str(e)}"}
• mcp_hetzner/server.py:112-158 (helper)

  Helper function that converts a Hetzner Cloud Firewall object into a structured dictionary, including detailed rules and applied resources, used by the list_firewalls handler.
  # Helper function to convert Firewall object to dict def firewall_to_dict(firewall: Firewall) -> Dict[str, Any]: """Convert a Firewall object to a dictionary with relevant information.""" # Convert rules to dict rules = [] if firewall.rules: for rule in firewall.rules: rule_dict = { "direction": rule.direction, "protocol": rule.protocol, "source_ips": rule.source_ips, } if rule.port: rule_dict["port"] = rule.port if rule.destination_ips: rule_dict["destination_ips"] = rule.destination_ips if rule.description: rule_dict["description"] = rule.description rules.append(rule_dict) # Convert applied_to resources to dict applied_to = [] if firewall.applied_to: for resource in firewall.applied_to: resource_dict = {"type": resource.type} if resource.server: resource_dict["server"] = {"id": resource.server.id, "name": resource.server.name} if resource.label_selector: resource_dict["label_selector"] = {"selector": resource.label_selector.selector} if getattr(resource, 'applied_to_resources', None): applied_resources = [] for applied_resource in resource.applied_to_resources: applied_resource_dict = {"type": applied_resource.type} if applied_resource.server: applied_resource_dict["server"] = {"id": applied_resource.server.id, "name": applied_resource.server.name} applied_resources.append(applied_resource_dict) resource_dict["applied_to_resources"] = applied_resources applied_to.append(resource_dict) return { "id": firewall.id, "name": firewall.name, "rules": rules, "applied_to": applied_to, "labels": firewall.labels, "created": firewall.created.isoformat() if firewall.created else None, }