de en es ja ko ru zh

Hetzner Cloud MCP Server — Cloud API + SSH management (60 tools)

Name: Hetzner Cloud MCP Server — Cloud API + SSH management (60 tools)
Author: wbf-solutions

by wbf-solutions

Overview Schema Source Related Servers Discussions Admin

Remote

Servidor MCP de Hetzner Cloud

El único MCP de Hetzner con gestión de servidores SSH. API + SSH en una sola herramienta.

PHP 8.1+ License: MIT MCP Protocol

Gestiona tu infraestructura de Hetzner Cloud desde Claude.ai, Claude Desktop, VS Code, Cursor o cualquier cliente compatible con MCP. Lo mejor es que puedes controlar y construir cualquier cosa en tus servidores usando tu teléfono con Claude, ChatGPT o cualquier otra aplicación de chat con IA. Dos capas de gestión te brindan un control total:

Capa 1 — API de Hetzner Cloud: Energía del servidor, métricas, instantáneas, copias de seguridad, firewalls, zonas y registros DNS, modo rescate, reconstrucción y reescalado del servidor. Funciona incluso cuando el SO del servidor no responde.
Capa 2 — SSH: Servicios, registros, Nginx, MySQL, supervisor, cron, UFW, monitorización de disco/memoria/CPU. Herramientas reales de administración de sistemas, no solo envoltorios de API.

60 herramientas. Configuración dinámica de múltiples servidores. Autoalojado y de código abierto.

¿Por qué este MCP?

Todos los MCP de Hetzner existentes solo envuelven la API de Cloud. Este añade una capa completa de gestión SSH: las herramientas que realmente necesitas al gestionar servidores en producción. Dos capas, 60 herramientas, autoalojado.

Característica	Incluido
API de Cloud (energía del servidor, métricas, instantáneas, copias de seguridad, firewalls, rescate, reconstrucción)	Sí
Gestión SSH (servicios, registros, Nginx, MySQL, salud del sistema)	Sí
Gestión DNS (zonas, registros, CRUD)	Sí
Multi-servidor (de 1 a N servidores desde una única instancia)	Sí
Protecciones contra acciones destructivas (se requiere confirmación para operaciones peligrosas)	Sí
Transporte	SSE + HTTP con streaming
Lenguaje	PHP 8.1+

Related MCP server: hcloud-mcp

Inicio rápido

Requisitos previos

PHP 8.1+ con la extensión curl
Composer
Un token de API de Hetzner Cloud (Consola > Seguridad > Tokens de API)
Una clave SSH para acceso al servidor (herramientas de la Capa 2)

1. Clonar e instalar

git clone https://github.com/wbf-solutions/hetzner-cloud-mcp.git
cd hetzner-cloud-mcp
composer install

2. Configurar

cp .env.example .env

Edita .env con tus detalles:

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. Configurar la clave SSH

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. Configurar 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. Conectar a Claude.ai

Configuración > Conectores > Añadir conector personalizado:

Nombre: Hetzner Cloud MCP
URL: https://mcp.yourdomain.com/api.php

Si estableces MCP_API_KEY, pásala a través de la URL: ?mcp=sse&key=TU_CLAVE_MCP_API o configura la clave API en la Configuración avanzada del conector como un token Bearer.

Herramientas disponibles (60)

Capa 1 — API de Hetzner Cloud (25 herramientas)

Herramienta	Descripción	Destructiva
`server_info`	Detalles del servidor: estado, IP, tipo, centro de datos
`server_metrics`	Métricas de CPU, disco o red
`server_power_on`	Encender
`server_power_off`	Apagado forzado	Confirmar
`server_shutdown`	Apagado ACPI ordenado
`server_reboot`	Reinicio suave
`server_reset`	Reinicio forzado	Confirmar
`server_reset_password`	Restablecer contraseña root	Confirmar
`server_rescue_enable`	Activar modo rescate
`server_rescue_disable`	Desactivar modo rescate
`server_rebuild`	Reconstruir desde imagen (borra datos)	Confirmar
`server_change_type`	Reescalar plan del servidor	Confirmar
`snapshot_create`	Crear instantánea
`snapshot_list`	Listar instantáneas
`snapshot_delete`	Eliminar instantánea	Confirmar
`backup_enable`	Activar copias de seguridad (+20% coste)
`backup_disable`	Desactivar copias de seguridad	Confirmar
`firewall_list`	Listar firewalls
`firewall_get`	Obtener reglas de firewall
`firewall_set_rules`	Reemplazar todas las reglas de firewall	Confirmar
`firewall_apply_to_server`	Aplicar firewall al servidor
`firewall_remove_from_server`	Eliminar firewall del servidor
`project_servers_list`	Listar todos los servidores
`ssh_keys_list`	Listar claves SSH
`action_status`	Comprobar estado de acción asíncrona

DNS (8 herramientas, requiere `HETZNER_DNS_TOKEN`)

Herramienta	Descripción	Destructiva
`dns_zones_list`	Listar zonas DNS
`dns_zone_get`	Obtener detalles de zona
`dns_zone_create`	Crear zona DNS
`dns_zone_delete`	Eliminar zona DNS	Confirmar
`dns_records_list`	Listar registros en zona
`dns_record_add`	Añadir registro DNS
`dns_record_update`	Actualizar registro DNS
`dns_record_delete`	Eliminar registro DNS	Confirmar

Capa 2 — SSH (27 herramientas)

Herramienta	Descripción
`ssh_service_status`	Comprobar estado de servicio systemd
`ssh_service_start`	Iniciar un servicio
`ssh_service_stop`	Detener un servicio
`ssh_service_restart`	Reiniciar un servicio
`ssh_services_list`	Listar servicios en ejecución
`ssh_disk_usage`	Espacio en disco (`df -h`)
`ssh_memory_usage`	Uso de RAM (`free -h`)
`ssh_cpu_load`	Carga de CPU + procesos principales
`ssh_process_list`	Procesos principales por memoria/CPU
`ssh_uptime`	Tiempo de actividad del servidor
`ssh_nginx_test`	Probar sintaxis de configuración de Nginx
`ssh_nginx_reload`	Recargar Nginx (prueba primero)
`ssh_nginx_sites_list`	Listar sitios habilitados
`ssh_nginx_site_config`	Ver configuración de sitio Nginx
`ssh_logs_nginx_error`	Seguir registro de errores de Nginx
`ssh_logs_nginx_access`	Seguir registro de acceso de Nginx
`ssh_logs_syslog`	Seguir registro del sistema
`ssh_logs_journal`	Ver diario de systemd
`ssh_logs_supervisor`	Ver registros de supervisor
`ssh_mysql_databases`	Listar bases de datos MySQL
`ssh_mysql_processlist`	Mostrar procesos MySQL
`ssh_mysql_query`	Consulta SQL de solo lectura
`ssh_cron_list`	Listar entradas de crontab
`ssh_supervisor_status`	Estados de programas de supervisor
`ssh_supervisor_restart`	Reiniciar programa de supervisor
`ssh_ufw_status`	Comprobar firewall UFW
`ssh_exec`	Ejecutar comando (comandos peligrosos bloqueados)

Autenticación

Elige el modo que se ajuste a tu despliegue:

Modo	Configuración	Ideal para
Sin autenticación	`MCP_API_KEY=` (vacío), sin `OAUTH_*`	Detrás de VPN/firewall, desarrollo local
Clave API	`MCP_API_KEY=tu-clave`	Autoalojado, usuario único/equipo
Clave API + OAuth	Establecer variables `MCP_API_KEY` + `OAUTH_*`	Multi-usuario, Directorio de Conectores

Clave API (recomendado para autoalojamiento)

Genera una clave y establécela en .env:

openssl rand -hex 32

Los clientes pasan la clave como ?key=XXX o Authorization: Bearer XXX.

OAuth 2.1 (opcional)

Para despliegues avanzados o envío al Directorio de Conectores de Anthropic, puedes añadir introspección de token OAuth 2.1 junto con la clave API estática. Esto requiere un servidor de autorización OAuth externo con un endpoint de introspección (RFC 7662). Consulta .env.example para las variables OAUTH_*.

Seguridad

Autenticación: Clave API mediante parámetro de consulta o cabecera Authorization: Bearer. Introspección OAuth 2.1 opcional. Validación de tiempo constante.
Protecciones destructivas: Todas las operaciones peligrosas requieren confirm=true.
Anotaciones de herramientas: Todas las herramientas incluyen readOnlyHint y destructiveHint según la especificación MCP.
Seguridad SSH: 29 patrones de comandos bloqueados (rm -rf, dd, mkfs, curl|sh, passwd, fdisk, etc.).
SQL de solo lectura: Solo se permiten SELECT, SHOW, DESCRIBE, EXPLAIN.
Limitación de tasa: Por IP con flock() atómico.

Configuración

Define cualquier número de servidores en .env:

SERVERS=web,staging
SERVER_WEB_ID=12345678
SERVER_WEB_IP=1.2.3.4
SERVER_WEB_SSH_USER=root
SERVER_WEB_ALIASES=production,prod
SERVER_STAGING_ID=87654321
SERVER_STAGING_IP=5.6.7.8
DEFAULT_SERVER=web

SSH y DNS son opcionales: las herramientas se desactivan automáticamente cuando no están configuradas.

Consulta .env.example para la referencia completa.

Configuración del cliente

Cliente	Conexión
Claude.ai	Configuración > Conectores > Añadir conector personalizado con URL SSE
Claude Desktop	Añadir a `claude_desktop_config.json`
Claude Code	`claude mcp add --transport http hetzner URL --header "Authorization: Bearer KEY"`
VS Code / Cursor	Extensión de VS Code — próximamente

Despliegue

Funciona con VitoDeploy o configuración manual de Nginx + PHP-FPM. Requiere fastcgi_buffering off para streaming SSE. Consulta la guía de despliegue completa en la sección Inicio rápido.

Contribución

Consulta CONTRIBUTING.md. Vulnerabilidades de seguridad: labs@wbf.solutions.

Enlaces

Página de inicio: hetzner-cloud-mcp.wbf.tools
Creado por: WBF Solutions
Contacto: labs@wbf.solutions

Licencia

MIT — WBF Solutions | labs@wbf.solutions

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessSyncing

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

hostinger-api-mcpOAuth
io.github.hostinger
MCP server for Hostinger API
Cloud Platforms Developer Tools
1154
mcp-server
io.github.hostkey-cloud
MCP server for Hostkey .com (InvAPI): servers, power, order, DNS, S3, billing
Cloud Platforms Cloud Storage Payments & Billing
1
Os Automation Mcp C
io.github.varvararatta
MCP server for OS Automation
OS Automation Command Line
2
SevallaOAuth
io.github.sevalla-hosting
Official Sevalla MCP — full PaaS API access through just 2 tools.
Cloud Platforms Developer Tools
28

Related MCP Servers

Hetzner Cloud MCP Server
Cloud Platforms Shell Access
dkruyt
A
license
A
quality
D
maintenance
A Model Context Protocol server that allows language models to manage Hetzner Cloud resources through structured functions, including servers, volumes, firewalls, and SSH keys.
Updated a year ago (2025-04-10 07:58 UTC)
30
140
MIT
hcloud-mcp
Cloud Platforms Virtualization
Xodus-CO
A
license
C
quality
D
maintenance
A Model Context Protocol server for the Hetzner Cloud API that enables natural language management of cloud infrastructure. Users can list, create, and modify servers, networks, volumes, and load balancers through MCP-compatible clients.
Updated 7 months ago (2026-02-19 17:01 UTC)
67
36 npm
MIT
mcp-hetzner
Cloud Platforms Networking & Infrastructure Cloud Storage
ginkelsoft-development
A
license
B
quality
D
maintenance
Enables conversational management of Hetzner Cloud, DNS, and Storage Box infrastructure through 137 MCP tools for CRUD operations and actions like server power control, DNS zone management, and storage box snapshots.
Updated 4 months ago (2026-05-26 14:24 UTC)
100
MIT
hetzner-mcp
Cloud Platforms Networking & Infrastructure
devinoldenburg
A
license
Not graded
quality
A
maintenance
Model Context Protocol server for full Hetzner Cloud + Storage API automation. Exposes all official Hetzner operations as MCP tools so AI agents can manage servers, networking, load balancers, firewalls, volumes, DNS zones, and storage boxes from one server.
Updated 4 months ago (2026-05-25 05:34 UTC)
1
MIT