Hetzner 云 MCP 服务器
用于与 Hetzner Cloud API 交互的模型上下文协议 (MCP) 服务器。该服务器允许语言模型通过结构化函数管理 Hetzner Cloud 资源。
特征
- 列出、创建和管理 Hetzner Cloud 服务器
- 创建、附加、分离和调整卷大小
- 管理防火墙规则并将其应用于服务器
- 创建和管理 SSH 密钥以实现安全的服务器访问
- 查看可用的图像、服务器类型和位置
- 打开/关闭和重启服务器
- 用于语言模型交互的简单、结构化的 API
- Claude Code 集成，可直接从 Claude 管理 Hetzner 资源
要求
- Python 3.11+
- Hetzner 云 API 令牌
安装
方法一：直接安装
- 克隆此存储库：
git clone https://github.com/dkruyt/mcp-hetzner.git
cd mcp-hetzner
- 安装依赖项：
- 创建一个
.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
作为包安装后，使用您的 Hetzner Cloud API 令牌在您的工作目录中创建一个.env文件。
用法
启动服务器
选项 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 代码一起使用sse ：服务器发送事件传输，适用于 HTTP 客户端
默认情况下，服务器在localhost:8080上运行。您可以通过以下方式自定义主机和端口：
- 在
.env文件中设置MCP_HOST和MCP_PORT环境变量 - 使用
--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 ：列出可用的数据中心位置
执照
麻省理工学院