Hetzner Cloud MCP by usefulapi
Servers, volumes, networks, firewalls, load balancers, pricing and safe power operations.
使うべきか
品質と安全性
検出事項(3)
- LOWhetzner_reboot_server 内
- LOWhetzner_create_image_from_server 内
- LOWhetzner_change_server_protection 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"hetzner-cloud": {
"url": "https://hetzner-cloud.usefulapi.io/mcp"
}
}
}リモートエンドポイント
https://hetzner-cloud.usefulapi.io/mcpstreamable-httpできること
ツール一覧
ツール(32)
🟢hetzner_list_servers(name, status, label_selector, page, per_page)
List the servers in the token's project, optionally filtered by name, status or a label selector. Hetzner Cloud: GET /servers.
入力スキーマ
{
"type": "object",
"properties": {
"name": {
"description": "Only the server with this exact name.",
"type": "string"
},
"status": {
"description": "Only servers in this power state.",
"type": "string",
"enum": [
"running",
"initializing",
"starting",
"stopping",
"off",
"deleting",
"migrating",
"rebuilding",
"unknown"
]
},
"label_selector": {
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom.",
"type": "string"
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Page size, 1-50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_get_server(server_id)
Fetch a single server with its type, image, IPs, volumes, networks and protection flags. Hetzner Cloud: GET /servers/{id}.
入力スキーマ
{
"type": "object",
"properties": {
"server_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The server's numeric id."
}
},
"required": [
"server_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_get_server_metrics(server_id, type, start, end, step)
Fetch CPU, disk or network time series for one server over a window. Hetzner Cloud: GET /servers/{id}/metrics.
入力スキーマ
{
"type": "object",
"properties": {
"server_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The server's numeric id."
},
"type": {
"type": "string",
"enum": [
"cpu",
"disk",
"network"
],
"description": "Which metric family to return."
},
"start": {
"type": "string",
"description": "ISO-8601 start of the window."
},
"end": {
"type": "string",
"description": "ISO-8601 end of the window."
},
"step": {
"description": "Resolution in seconds.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"server_id",
"type",
"start",
"end"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_list_server_types(name, page, per_page)
List the available server types with their cores, memory, disk and hourly and monthly prices — read this before creating a server. Hetzner Cloud: GET /server_types.
入力スキーマ
{
"type": "object",
"properties": {
"name": {
"description": "Only the type with this name, e.g. cx22.",
"type": "string"
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Page size, 1-50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_list_images(type, name, architecture, label_selector, page, ...)
List OS images, snapshots and backups you can boot or restore from. Hetzner Cloud: GET /images.
入力スキーマ
{
"type": "object",
"properties": {
"type": {
"description": "Only images of this kind.",
"type": "string",
"enum": [
"system",
"snapshot",
"backup",
"app"
]
},
"name": {
"description": "Only the image with this name, e.g. ubuntu-24.04.",
"type": "string"
},
"architecture": {
"description": "Only images for this CPU architecture.",
"type": "string",
"enum": [
"x86",
"arm"
]
},
"label_selector": {
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom.",
"type": "string"
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Page size, 1-50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_list_locations(name)
List the datacentre locations (city, country, network zone) servers can run in. Hetzner Cloud: GET /locations.
入力スキーマ
{
"type": "object",
"properties": {
"name": {
"description": "Only the location with this name, e.g. fsn1.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_get_pricing
Fetch the full price list for the project's currency — server types, volumes, traffic, floating IPs, load balancers and backups. Hetzner Cloud: GET /pricing.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_get_action(action_id)
Fetch the status of one asynchronous action. Every write tool here returns an action id — poll it with this to see whether the operation finished. Hetzner Cloud: GET /actions/{id}.
入力スキーマ
{
"type": "object",
"properties": {
"action_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The action's numeric id."
}
},
"required": [
"action_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_list_volumes(name, label_selector, page, per_page)
List block-storage volumes, their size and which server they are attached to. Hetzner Cloud: GET /volumes.
入力スキーマ
{
"type": "object",
"properties": {
"name": {
"description": "Only the resource with this exact name.",
"type": "string"
},
"label_selector": {
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom.",
"type": "string"
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Page size, 1-50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_get_volumes(id)
Fetch a single resource by id. Hetzner Cloud: GET /volumes/{id}.
入力スキーマ
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The resource's numeric id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_list_networks(name, label_selector, page, per_page)
List private networks, their IP ranges, subnets and routes. Hetzner Cloud: GET /networks.
入力スキーマ
{
"type": "object",
"properties": {
"name": {
"description": "Only the resource with this exact name.",
"type": "string"
},
"label_selector": {
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom.",
"type": "string"
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Page size, 1-50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_get_networks(id)
Fetch a single resource by id. Hetzner Cloud: GET /networks/{id}.
入力スキーマ
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The resource's numeric id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_list_firewalls(name, label_selector, page, per_page)
List firewalls, their rules and which resources they are applied to. Hetzner Cloud: GET /firewalls.
入力スキーマ
{
"type": "object",
"properties": {
"name": {
"description": "Only the resource with this exact name.",
"type": "string"
},
"label_selector": {
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom.",
"type": "string"
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Page size, 1-50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_get_firewalls(id)
Fetch a single resource by id. Hetzner Cloud: GET /firewalls/{id}.
入力スキーマ
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The resource's numeric id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_list_load_balancers(name, label_selector, page, per_page)
List load balancers, their services, targets and health status. Hetzner Cloud: GET /load_balancers.
入力スキーマ
{
"type": "object",
"properties": {
"name": {
"description": "Only the resource with this exact name.",
"type": "string"
},
"label_selector": {
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom.",
"type": "string"
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Page size, 1-50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_get_load_balancers(id)
Fetch a single resource by id. Hetzner Cloud: GET /load_balancers/{id}.
入力スキーマ
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The resource's numeric id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_list_ssh_keys(name, label_selector, page, per_page)
List the SSH public keys available to inject when creating a server. Hetzner Cloud: GET /ssh_keys.
入力スキーマ
{
"type": "object",
"properties": {
"name": {
"description": "Only the resource with this exact name.",
"type": "string"
},
"label_selector": {
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom.",
"type": "string"
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Page size, 1-50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_get_ssh_keys(id)
Fetch a single resource by id. Hetzner Cloud: GET /ssh_keys/{id}.
入力スキーマ
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The resource's numeric id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_list_floating_ips(name, label_selector, page, per_page)
List floating IPs and which server each is assigned to. Hetzner Cloud: GET /floating_ips.
入力スキーマ
{
"type": "object",
"properties": {
"name": {
"description": "Only the resource with this exact name.",
"type": "string"
},
"label_selector": {
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom.",
"type": "string"
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Page size, 1-50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_get_floating_ips(id)
Fetch a single resource by id. Hetzner Cloud: GET /floating_ips/{id}.
入力スキーマ
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The resource's numeric id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_list_primary_ips(name, label_selector, page, per_page)
List primary IPs and their assignments. Hetzner Cloud: GET /primary_ips.
入力スキーマ
{
"type": "object",
"properties": {
"name": {
"description": "Only the resource with this exact name.",
"type": "string"
},
"label_selector": {
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom.",
"type": "string"
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Page size, 1-50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_get_primary_ips(id)
Fetch a single resource by id. Hetzner Cloud: GET /primary_ips/{id}.
入力スキーマ
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The resource's numeric id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_list_certificates(name, label_selector, page, per_page)
List TLS certificates, managed or uploaded, and their expiry. Hetzner Cloud: GET /certificates.
入力スキーマ
{
"type": "object",
"properties": {
"name": {
"description": "Only the resource with this exact name.",
"type": "string"
},
"label_selector": {
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom.",
"type": "string"
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Page size, 1-50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_get_certificates(id)
Fetch a single resource by id. Hetzner Cloud: GET /certificates/{id}.
入力スキーマ
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The resource's numeric id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hetzner_create_server(name, server_type, image, location, ssh_keys, ...)
Provision a new server. THIS STARTS BILLING: the chosen server type is charged by the hour from the moment it boots. Call hetzner_list_server_types first to see prices, and hetzner_list_images for a bootable image. Hetzner Cloud: POST /servers.
入力スキーマ
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "A unique name for the server (also its hostname)."
},
"server_type": {
"type": "string",
"description": "Server type name, e.g. cx22. See hetzner_list_server_types."
},
"image": {
"type": "string",
"description": "Image name or id to boot, e.g. ubuntu-24.04."
},
"location": {
"description": "Location name, e.g. fsn1. Defaults to Hetzner's choice.",
"type": "string"
},
"ssh_keys": {
"description": "SSH key names or ids to authorise. Without one, Hetzner emails a root password.",
"type": "array",
"items": {
"type": "string"
}
},
"start_after_create": {
"description": "Boot the server immediately. Defaults to true.",
"type": "boolean"
},
"user_data": {
"description": "cloud-init user data to run on first boot.",
"type": "string"
},
"labels": {
"description": "Labels for filtering later.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
}
},
"required": [
"name",
"server_type",
"image"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hetzner_poweron_server(server_id)
Power on a stopped server. Returns an action id — poll it with hetzner_get_action. Hetzner Cloud: POST /servers/{id}/actions/poweron.
入力スキーマ
{
"type": "object",
"properties": {
"server_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The server to start."
}
},
"required": [
"server_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hetzner_shutdown_server(server_id)
Ask the guest OS to shut down gracefully via ACPI. Prefer this over a hard power-off. Note that a stopped server still costs money — only deleting it stops the bill. Hetzner Cloud: POST /servers/{id}/actions/shutdown.
入力スキーマ
{
"type": "object",
"properties": {
"server_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The server to shut down."
}
},
"required": [
"server_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hetzner_reboot_server(server_id)
Reboot a server gracefully via ACPI. Hetzner Cloud: POST /servers/{id}/actions/reboot.
入力スキーマ
{
"type": "object",
"properties": {
"server_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The server to reboot."
}
},
"required": [
"server_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hetzner_create_image_from_server(server_id, description, type)
Create a snapshot image from a server's disk — the safe thing to do BEFORE a risky change. Snapshots are billed for the space they use. Hetzner Cloud: POST /servers/{id}/actions/create_image.
入力スキーマ
{
"type": "object",
"properties": {
"server_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The server to snapshot."
},
"description": {
"description": "A label for the snapshot.",
"type": "string"
},
"type": {
"description": "snapshot (kept until deleted) or backup (uses a backup slot). Defaults to snapshot.",
"type": "string",
"enum": [
"snapshot",
"backup"
]
}
},
"required": [
"server_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hetzner_enable_server_backup(server_id)
Turn on automatic backups for a server. This adds roughly 20% to the server's price. Hetzner Cloud: POST /servers/{id}/actions/enable_backup.
入力スキーマ
{
"type": "object",
"properties": {
"server_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The server to protect."
}
},
"required": [
"server_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hetzner_disable_server_backup(server_id)
Turn off automatic backups for a server. Existing backups are DELETED. Hetzner Cloud: POST /servers/{id}/actions/disable_backup.
入力スキーマ
{
"type": "object",
"properties": {
"server_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The server to stop backing up."
}
},
"required": [
"server_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hetzner_change_server_protection(server_id, delete, rebuild)
Turn deletion and rebuild protection on or off for a server. Turning protection ON is the safest write in this server. Hetzner Cloud: POST /servers/{id}/actions/change_protection.
入力スキーマ
{
"type": "object",
"properties": {
"server_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The server to protect."
},
"delete": {
"description": "Protect the server from deletion.",
"type": "boolean"
},
"rebuild": {
"description": "Protect the server from rebuild.",
"type": "boolean"
}
},
"required": [
"server_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}コミュニティ
エビデンス