Hetzner Cloud MCP Server

Instructions

List all servers in your Hetzner Cloud account.

Returns a list of all server instances with their details.

Example:
- Basic list: list_servers()

Implementation Reference

• mcp_hetzner/server.py:257-274 (handler)

  The handler function for the 'list_servers' MCP tool. It fetches all servers from the Hetzner Cloud API using the client and converts each to a dictionary using the server_to_dict helper, returning them in a 'servers' list or an error message.

  @mcp.tool()
  def list_servers() -> Dict[str, Any]:
      """
      List all servers in your Hetzner Cloud account.
      
      Returns a list of all server instances with their details.
      
      Example:
      - Basic list: list_servers()
      """
      try:
          servers = client.servers.get_all()
          return {
              "servers": [server_to_dict(server) for server in servers]
          }
      except Exception as e:
          return {"error": f"Failed to list servers: {str(e)}"}

• mcp_hetzner/server.py:52-79 (helper)

  Helper function that converts a Hetzner Server object to a dictionary containing key details like id, name, status, networking info, protection settings, and labels. Used by list_servers and other server-related tools.

  def server_to_dict(server: Server) -> Dict[str, Any]:
      """Convert a Server object to a dictionary with relevant information."""
      return {
          "id": server.id,
          "name": server.name,
          "status": server.status,
          "created": server.created.isoformat() if server.created else None,
          "server_type": server.server_type.name if server.server_type else None,
          "image": server.image.name if server.image else None,
          "datacenter": server.datacenter.name if server.datacenter else None,
          "location": server.datacenter.location.name if server.datacenter and server.datacenter.location else None,
          "public_net": {
              "ipv4": server.public_net.ipv4.ip if server.public_net and server.public_net.ipv4 else None,
              "ipv6": server.public_net.ipv6.ip if server.public_net and server.public_net.ipv6 else None,
          },
          "included_traffic": server.included_traffic,
          "outgoing_traffic": server.outgoing_traffic,
          "ingoing_traffic": server.ingoing_traffic,
          "backup_window": server.backup_window,
          "rescue_enabled": server.rescue_enabled,
          "locked": server.locked,
          "protection": {
              "delete": server.protection["delete"] if server.protection else False,
              "rebuild": server.protection["rebuild"] if server.protection else False,
          },
          "labels": server.labels,
          "volumes": [volume.id for volume in server.volumes] if server.volumes else [],
      }

• mcp_hetzner/server.py:257-257 (registration)

  The @mcp.tool() decorator registers the list_servers function as an MCP tool in the FastMCP server instance.

  @mcp.tool()