Hetzner Cloud MCP Server — (Cloud API + SSH)

### Prerequisites - PHP 8.1+ with `curl` extension - Composer - A Hetzner Cloud API token ([Console > Security > API Tokens](https://console.hetzner.com)) - An SSH key for server access (Layer 2 tools) ### 1. Clone and install ```bash git clone https://github.com/wbf-solutions/hetzner-cloud-mcp.git cd hetzner-cloud-mcp composer install ``` ### 2. Configure ```bash cp .env.example .env ``` Edit `.env` with your details: ```env HETZNER_API_TOKEN=your-cloud-api-token SERVERS=web SERVER_WEB_ID=12345678 SERVER_WEB_IP=1.2.3.4 SERVER_WEB_SSH_USER=root SSH_KEY_PATH=/root/.ssh/id_ed25519 MCP_API_KEY=your-random-key # generate with: openssl rand -hex 32 ``` ### 3. Set up the SSH key ```bash ssh-keygen -t ed25519 -f /root/.ssh/id_ed25519 -N "" ssh-copy-id -i /root/.ssh/id_ed25519.pub root@1.2.3.4 ``` ### 4. Configure Nginx ```nginx server { listen 443 ssl; server_name mcp.yourdomain.com; ssl_certificate /etc/letsencrypt/live/mcp.yourdomain.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/mcp.yourdomain.com/privkey.pem; root /var/www/hetzner-cloud-mcp; index api.php; location / { try_files $uri /api.php?$query_string; } location ~ \.php$ { fastcgi_pass unix:/var/run/php/php8.1-fpm.sock; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; fastcgi_buffering off; fastcgi_read_timeout 600; } } ``` ### 5. Connect to Claude.ai **Settings > Connectors > Add custom connector:** - **Name:** Hetzner Cloud MCP - **URL:** `https://mcp.yourdomain.com/api.php` If you set `MCP_API_KEY`, pass it via the URL: `?mcp=sse&key=YOUR_MCP_API_KEY` or configure the API key in the connector's Advanced Settings as a Bearer token. ---