mcp-hetzner
MCP (Model Context Protocol) server for Hetzner Cloud API integration.
Features
- Full Hetzner Cloud API coverage
- Server management (create, delete, power on/off, reboot, rebuild)
- Volume management (create, attach, detach, resize)
- Network management (create, delete, subnets, routes)
- Firewall management (create, delete, set rules)
- SSH key management
- Floating IP management
- Image listing and management
- Action status tracking
- Read-only resources for server types, locations, datacenters, and pricing
Installation```bash
bun install
## Configuration
Set the `HETZNER_API_TOKEN` environment variable with your Hetzner Cloud API token. You can get one from the Hetzner Cloud Console.
### Claude Desktop Configuration
Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):```json
{
"mcpServers": {
"hetzner": {
"command": "bun",
"args": ["run", "/path/to/mcp-hetzner/src/index.ts"],
"env": {
"HETZNER_API_TOKEN": "your-token-here"
}
}
}
}
Usage
Running the Server```bash
Start the server
bun run start
Development mode with watch
bun run dev
### Testing with MCP Inspector```bash
bun run inspect
Available Tools
Server Management
| Tool | Description |
|---|---|
server_list |
List all servers |
server_get |
Get server details |
server_create |
Create a new server |
server_delete |
Delete a server |
server_power_on |
Power on a server |
server_power_off |
Force power off |
server_shutdown |
Graceful shutdown |
server_reboot |
Reboot a server |
server_reset |
Force reset |
server_rebuild |
Rebuild with new image |
server_change_type |
Change server type |
server_enable_rescue |
Enable rescue mode |
server_disable_rescue |
Disable rescue mode |
Volume Management
| Tool | Description |
|---|---|
volume_list |
List all volumes |
volume_get |
Get volume details |
volume_create |
Create a new volume |
volume_delete |
Delete a volume |
volume_attach |
Attach to server |
volume_detach |
Detach from server |
volume_resize |
Resize a volume |
Network Management
| Tool | Description |
|---|---|
network_list |
List all networks |
network_get |
Get network details |
network_create |
Create a new network |
network_delete |
Delete a network |
network_add_subnet |
Add a subnet |
network_delete_subnet |
Delete a subnet |
network_add_route |
Add a route |
network_delete_route |
Delete a route |
Firewall Management
| Tool | Description |
|---|---|
firewall_list |
List all firewalls |
firewall_get |
Get firewall details |
firewall_create |
Create a new firewall |
firewall_delete |
Delete a firewall |
firewall_set_rules |
Set firewall rules |
firewall_apply_to_resources |
Apply to servers |
firewall_remove_from_resources |
Remove from servers |
SSH Key Management
| Tool | Description |
|---|---|
ssh_key_list |
List all SSH keys |
ssh_key_get |
Get SSH key details |
ssh_key_create |
Create a new SSH key |
ssh_key_delete |
Delete an SSH key |
ssh_key_update |
Update SSH key |
Floating IP Management
| Tool | Description |
|---|---|
floating_ip_list |
List all floating IPs |
floating_ip_get |
Get floating IP details |
floating_ip_create |
Create a new floating IP |
floating_ip_delete |
Delete a floating IP |
floating_ip_assign |
Assign to server |
floating_ip_unassign |
Unassign from server |
floating_ip_update |
Update floating IP |
Image Management
| Tool | Description |
|---|---|
image_list |
List all images |
image_get |
Get image details |
image_update |
Update image |
image_delete |
Delete image |
Action Management
| Tool | Description |
|---|---|
action_get |
Get action status |
action_list |
List all actions |
Available Resources
| Resource URI | Description |
|---|---|
hetzner://server-types |
Available server types with specs and pricing |
hetzner://locations |
Datacenter locations |
hetzner://datacenters |
Datacenters with supported server types |
hetzner://pricing |
Current pricing information |
Development```bash
Run linter
bun run lint
Type check
bun run typecheck
Run tests
bun test
```
License
MIT
