MCP Hetzner Go

A Go Model Context Protocol (MCP) server for interacting with the Hetzner Cloud API.

🌟 Featured

🎉 **Now part of the official Awesome HCloud list!**

Using with Claude Desktop

Create a file in ~/Library/Application Support/Claude/claude_desktop_config.json with the following contents:

{
  "mcpServers": {
    "hetzner": {
      "command": "",
      "env": {
        "HCLOUD_TOKEN": "YOUR-HCLOUD-TOKEN"
      }
    }
  }
}

🛠 Build Client

npm --prefix ./client i
npm --prefix ./client run build

🖥 Build Server

go mod init github.com/MahdadGhasemian/mcp-hetzner-go
go mod tidy
go build -o mcphetzner
# go run .

🚀 Run Client

node ./client/build/index.js ./mcphetzner

⚠️ Usage Restrictions

The server supports two operation modes, controlled by the configuration:

• Read-Only mode: Only allows GET and LIST operations.
• Read-Write mode: Allows GET, LIST, and CREATE/UPDATE/DELETE operations.

By default, the server starts in read-only mode.

To enable write operations (such as creating, updating, or deleting resources), you must explicitly set the configuration flag to enable read-write mode.

> Warning: Enabling write mode allows the client to make changes to your Hetzner Cloud resources.

> Ensure you understand the implications and have proper access controls in place.

Switching Modes

Edit your configuration or pass the relevant environment variable/flag at launch:

• For read-only (default; safe for inspection and monitoring):

./mcphetzner --restriction=read_only

• For read-write (use with caution!):

./mcphetzner --restriction=read_write

✅ Lint

# install golangci-lint and then run:
golangci-lint run

🔍 Inspector

npx @modelcontextprotocol/inspector

🗺 Roadmap

• [x] Implement all GET and LIST operations for:
  • [x] Certificates
  • [x] SSH Keys
  • [x] Locations
  • [x] Datacenters
  • [x] Firewall
  • [x] Floating IPs
  • [x] Servers
  • [x] Images
  • [x] ISOs
  • [x] Placement Groups
  • [x] Primary IPs
  • [x] Server Types
  • [x] Load Balancers
  • [x] Load Balancer Types
  • [x] Networks
  • [x] Volumes
  • [x] Pricing

• [x] Add a configuration flag or setting to:
  • [x] Enable read_only mode (GET/LIST only)
  • [x] Enable read_write mode (GET/LIST + CREATE/UPDATE/DELETE)

• [ ] Implement write operations (create/update):
  • [ ] Certificates
  • [ ] SSH Keys
  • [ ] Firewall
  • [ ] Floating IPs
  • [ ] Servers
  • [ ] Images
  • [ ] Placement Groups
  • [ ] Primary IPs
  • [ ] Load Balancers
  • [ ] Networks
  • [ ] Volumes

• [ ] Add delete capabilities for supported resources