内容
# Hetzner MCP
一款适用于 [Cursor Plugin 市场](https://cursor.com/marketplace) 的 **Cursor 插件**。使用自然语言和 AI 驱动的工作流程直接从 Cursor 管理 Hetzner Cloud 资源。
[获取 Hetzner Cloud](https://hetzner.cloud/?ref=IAYKetqPnlq9) — 新用户注册可获得 €20 积分。
<img src="plugins/hetzner-mcp/assets/hetzner.svg" width="140" alt="Hetzner 标志" />
## 功能
- **服务器**：创建、删除、开机/关机、重启、调整大小；连接到网络和 ISO
- **负载均衡器**：完整的 CRUD，增加/删除目标和服务；`list_load_balancer_types` 用于创建
- **网络**：创建/删除网络；增加/删除子网（例如，每个区域的 10.0.0.0/16 用于私有网络）
- **卷**：创建、连接、断开、删除块存储
- **防火墙**：创建、更新、删除防火墙
- **浮动 IP**：创建、分配、解除分配、删除
- **主 IP**：创建、分配、解除分配、删除（数据中心范围的静态 IP；服务器必须关闭才能分配/解除分配）
- **SSH 密钥**：完整的 CRUD
- **放置组**：完整的 CRUD，用于反亲和力组
- **元数据和操作**：位置、镜像、服务器类型、负载均衡器类型、数据中心；`list_actions` / `get_action` 用于轮询创建/删除结果
所有操作都通过 Cursor 的 AI 代理的自然语言进行。
## 安装
从 [Cursor Plugin 市场](https://cursor.com/marketplace) 安装插件，然后设置您的 Hetzner API 令牌：在 Cursor **设置 → 功能 → 模型上下文协议** 中，找到 `hetzner-cloud` 服务器并在其环境中设置 `HCLOUD_TOKEN`。
## 使用
要求 Cursor 的代理管理您的 Hetzner 基础设施：
**简单**
- "列出我在纽伦堡的服务器"
- "创建一个带有 Ubuntu 24.04 的 cx22 服务器"
- "将一个 10GB 卷连接到 web-01"
- "为我的网络服务器设置负载均衡器"
- "显示 cpx31 服务器的当前定价"
**复杂**
- "在 eu-central 创建一个私有网络 10.0.0.0/16，添加一个子网，然后在该区域（例如 fsn1 和 nbg1）创建两个服务器并连接它们"
- "为 SSH 和 HTTP 创建防火墙，连接到我的网络服务器，然后创建负载均衡器并添加这些服务器作为目标"
- "列出正在运行的操作并获取操作 12345 的状态"
- "在 ash-dc1 中创建一个主 IP，关闭 web-01，分配 IP，然后重新启动"
- "拆除：断开/删除卷，删除负载均衡器和防火墙，解除/删除浮动 IP，删除服务器 web-01 和 web-02"
## 配置
在您的环境中设置 `HCLOUD_TOKEN` 或在 `plugins/hetzner-mcp/mcp.json` 中配置：
```json
{
"mcpServers": {
"hetzner-cloud": {
"command": "node",
"args": ["dist/index.js"],
"env": {
"HCLOUD_TOKEN": "your_token_here"
}
}
}
}
```
## 开发
- **源代码**：`plugins/hetzner-mcp/src/`
- **构建**：`npm run build`
- **验证**：`npm run validate`
参见 `plugins/hetzner-mcp/README.md` 以获取详细文档。
## 许可证
MIT
