Servidor MCP en la nube de Hetzner

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la API de Hetzner Cloud. Este servidor permite que los modelos de lenguaje gestionen los recursos de Hetzner Cloud mediante funciones estructuradas.

Características

Enumerar, crear y administrar servidores de Hetzner Cloud
Crear, adjuntar, separar y redimensionar volúmenes
Administrar reglas de firewall y aplicarlas a los servidores
Cree y administre claves SSH para un acceso seguro al servidor
Ver imágenes disponibles, tipos de servidores y ubicaciones
Encender, apagar y reiniciar servidores
API simple y estructurada para la interacción con modelos de lenguaje
Integración de Claude Code para gestionar recursos de Hetzner directamente desde Claude

Requisitos

Python 3.11+
Token de API de Hetzner Cloud

Instalación

Método 1: Instalación directa

Clonar este repositorio:

git clone https://github.com/dkruyt/mcp-hetzner.git
cd mcp-hetzner

Instalar dependencias:

pip install -e .

Cree un archivo .env y agregue su token de API de Hetzner Cloud:

HCLOUD_TOKEN=your_hetzner_cloud_api_token_here

Método 2: Instalar como paquete

# Install directly from the repository
pip install git+https://github.com/dkruyt/mcp-hetzner.git

Después de instalarlo como paquete, cree un archivo .env en su directorio de trabajo con su token de API de Hetzner Cloud.

Uso

Iniciando el servidor

Opción 1: Ejecutar el paquete instalado:

# Using default stdio transport
mcp-hetzner

# Using SSE transport
mcp-hetzner --transport sse

# Setting a custom port
mcp-hetzner --transport sse --port 8000

Opción 2: Ejecutar como módulo:

python -m mcp_hetzner
# or
python -m mcp_hetzner.server

El servidor admite dos modos de transporte:

stdio (predeterminado): transporte de E/S estándar, normalmente utilizado con Claude Code
sse : Transporte de eventos enviados por el servidor, adecuado para clientes HTTP

De forma predeterminada, el servidor se ejecuta en localhost:8080 . Puede personalizar el host y el puerto mediante:

Configuración de las variables de entorno MCP_HOST y MCP_PORT en su archivo .env
Usando el argumento de línea de comando --port (anula la variable de entorno)

Uso con Claude Code

Para usar con Claude Code, ejecute el servidor con transporte SSE:

# Start the server with SSE transport
mcp-hetzner --transport sse --port 8080

# In another terminal, connect Claude Code to the server
claude-code --mcp-server localhost:8080

Probando la API

Se incluye un cliente de prueba para verificar la funcionalidad del servidor:

python -m mcp_hetzner.client

Flujos de trabajo de ejemplo

Gestión básica del servidor

# List all your servers
list_servers

# Create a new server
create_server {
  "name": "web-server", 
  "server_type": "cx11", 
  "image": "ubuntu-22.04"
}

# Power operations
power_off {"server_id": 12345}
power_on {"server_id": 12345}
reboot {"server_id": 12345}

# Delete a server when no longer needed
delete_server {"server_id": 12345}

Gestión de volumen

# List all volumes
list_volumes

# Create a new volume
create_volume {
  "name": "data-volume",
  "size": 10,
  "location": "nbg1",
  "format": "ext4"
}

# Attach volume to a server
attach_volume {
  "volume_id": 12345,
  "server_id": 67890,
  "automount": true
}

# Detach volume from server
detach_volume {
  "volume_id": 12345
}

# Resize a volume (can only increase size)
resize_volume {
  "volume_id": 12345,
  "size": 50
}

# Delete a volume when no longer needed
delete_volume {
  "volume_id": 12345
}

Gestión de firewalls

# List all firewalls
list_firewalls

# Create a firewall for web servers
create_firewall {
  "name": "web-firewall",
  "rules": [
    {
      "direction": "in",
      "protocol": "tcp",
      "port": "80",
      "source_ips": ["0.0.0.0/0", "::/0"]
    },
    {
      "direction": "in",
      "protocol": "tcp",
      "port": "443",
      "source_ips": ["0.0.0.0/0", "::/0"]
    }
  ]
}

# Apply firewall to a server
apply_firewall_to_resources {
  "firewall_id": 12345,
  "resources": [
    {
      "type": "server",
      "server_id": 67890
    }
  ]
}

Administración de claves SSH

# List all SSH keys
list_ssh_keys

# Create a new SSH key
create_ssh_key {
  "name": "my-laptop",
  "public_key": "ssh-rsa AAAAB3NzaC1yc2EAAA... user@laptop"
}

# Use the SSH key when creating a server
create_server {
  "name": "secure-server",
  "server_type": "cx11",
  "image": "ubuntu-22.04",
  "ssh_keys": [12345]
}

# Update an SSH key's name
update_ssh_key {
  "ssh_key_id": 12345,
  "name": "work-laptop"
}

# Delete an SSH key
delete_ssh_key {
  "ssh_key_id": 12345
}

Planificación de infraestructura

# Explore available resources
list_server_types
list_images
list_locations

# Get specific server information
get_server {"server_id": 12345}

Funciones disponibles

El servidor MCP proporciona las siguientes funciones:

Administración de servidores

list_servers : enumera todos los servidores en su cuenta de Hetzner Cloud
get_server : Obtener detalles sobre un servidor específico
create_server : Crea un nuevo servidor
delete_server : Eliminar un servidor
power_on : Encender un servidor
power_off : Apagar un servidor
reboot : reiniciar un servidor

Gestión de volumen

list_volumes : enumera todos los volúmenes en su cuenta de Hetzner Cloud
get_volume : Obtener detalles sobre un volumen específico
create_volume : Crea un nuevo volumen
delete_volume : Eliminar un volumen
attach_volume : Adjuntar un volumen a un servidor
detach_volume : Separar un volumen de un servidor
resize_volume : Aumenta el tamaño de un volumen

Gestión de firewalls

list_firewalls : enumera todos los firewalls en su cuenta de Hetzner Cloud
get_firewall : Obtener detalles sobre un firewall específico
create_firewall : Crea un nuevo firewall
update_firewall : Actualizar el nombre o las etiquetas del firewall
delete_firewall : Eliminar un firewall
set_firewall_rules : Establecer o actualizar reglas de firewall
apply_firewall_to_resources : Aplicar un firewall a servidores o grupos de servidores
remove_firewall_from_resources : eliminar un firewall de servidores o grupos de servidores

Administración de claves SSH

list_ssh_keys : enumera todas las claves SSH en su cuenta de Hetzner Cloud
get_ssh_key : obtener detalles sobre una clave SSH específica
create_ssh_key : Crea una nueva clave SSH
update_ssh_key : Actualizar el nombre o las etiquetas de la clave SSH
delete_ssh_key : Eliminar una clave SSH

Información

list_images : Lista de imágenes del sistema operativo disponibles
list_server_types : Lista los tipos de servidores disponibles
list_locations : Lista de ubicaciones de centros de datos disponibles

Licencia

Instituto Tecnológico de Massachusetts (MIT)