Hetzner云MCP服务器
用于与Hetzner Cloud API交互的模型上下文协议（MCP）服务器。该服务器允许语言模型通过结构化函数管理Hetzner Cloud资源。
特性
- 列出、创建和管理Hetzner Cloud服务器
- 创建、附着、分离和调整卷大小
- 管理防火墙规则并将其应用于服务器
- 创建和管理SSH密钥以实现安全的服务器访问
- 查看可用图像、服务器类型和位置
- 打开/关闭电源并重新启动服务器
- 用于语言模型交互的简单、结构化的API
- Claude代码集成，用于直接从Claude管理Hetzner资源
需求
- Python 3.11+
- Hetzner Cloud API代币
安装
方法1：直接安装
- 克隆此存储库：
git clone https://github.com/dkruyt/mcp-hetzner.git
cd mcp-hetzner- 安装依赖项：
pip install -e .- 创建一个
.env文件并添加您的Hetzner Cloud API令牌：
HCLOUD_TOKEN=your_hetzner_cloud_api_token_here方法2：作为包安装
# Install directly from the repository
pip install git+https://github.com/dkruyt/mcp-hetzner.git作为软件包安装后，创建 .env 文件与Hetzer Cloud API令牌一起保存在您的工作目录中。
用法
启动服务器
选项1：运行已安装的软件包：
# Using default stdio transport
mcp-hetzner
# Using SSE transport
mcp-hetzner --transport sse
# Setting a custom port
mcp-hetzner --transport sse --port 8000选项2：作为模块运行：
python -m mcp_hetzner
# or
python -m mcp_hetzner.server服务器支持两种传输模式：
stdio（默认）：标准I/O传输，通常与Claude Code一起使用sse：服务器发送事件传输，适用于HTTP客户端
默认情况下，服务器运行在 localhost:8080。您可以通过以下方式自定义主机和端口：
- 设置
MCP_HOST和MCP_PORT您的环境变量.env文件 - 使用
--port命令行参数（覆盖环境变量）
使用Claude代码
要与Claude Code一起使用，请使用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测试API
包含一个测试客户端来验证服务器功能：
python -m mcp_hetzner.client示例工作流
基本服务器管理
# 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}卷管理
# 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
}防火墙管理
# 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
}
]
}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
}基础设施规划
# Explore available resources
list_server_types
list_images
list_locations
# Get specific server information
get_server {"server_id": 12345}可用功能
MCP服务器提供以下功能：
服务器管理
list_servers：列出您Hetzner Cloud帐户中的所有服务器get_server：获取特定服务器的详细信息create_server：创建新服务器delete_server：删除服务器power_on：打开服务器电源power_off：关闭服务器电源reboot：重新启动服务器
卷管理
list_volumes：列出Hetzner Cloud帐户中的所有卷get_volume：获取特定卷的详细信息create_volume：创建新卷delete_volume：删除卷attach_volume：将卷附加到服务器detach_volume：从服务器分离卷resize_volume：增加卷的大小
防火墙管理
list_firewalls：列出您Hetzner Cloud帐户中的所有防火墙get_firewall：获取特定防火墙的详细信息create_firewall：创建新防火墙update_firewall：更新防火墙名称或标签delete_firewall：删除防火墙set_firewall_rules：设置或更新防火墙规则apply_firewall_to_resources：对服务器或服务器组应用防火墙remove_firewall_from_resources：从服务器或服务器组中删除防火墙
SSH密钥管理
list_ssh_keys：列出您Hetzner Cloud帐户中的所有SSH密钥get_ssh_key：获取特定SSH密钥的详细信息create_ssh_key：创建新的SSH密钥update_ssh_key：更新SSH密钥名称或标签delete_ssh_key：删除SSH密钥
信息
list_images：列出可用的操作系统映像list_server_types：列出可用的服务器类型list_locations：列出可用的数据中心位置
许可证
麻省理工学院