AI导哈

Hetzner云API服务器管理工具

MCP服务器提供全面的Hetzner云API集成功能，包括服务器、存储、网络和安全管理。

  • by valerius21
  • TypeScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 valerius21/hetzner-mcp

使用说明

mcp-hetzner 的

用于Hetzner Cloud API集成的MCP（模型上下文协议）服务器。

特性

  • Hetzner Cloud API全面覆盖
  • 服务器管理（创建、删除、打开/关闭电源、重新启动、重建）
  • 卷管理（创建、附加、分离、调整大小）
  • 网络管理（创建、删除、子网、路由）
  • 防火墙管理（创建、删除、设置规则）
  • SSH密钥管理
  • 浮动IP管理
  • 图片列表和管理
  • 行动状态跟踪
  • 服务器类型、位置、数据中心和定价的只读资源

安装

bun install

配置

设置 HETZNER_API_TOKEN Hetzner Cloud API令牌的环境变量。你可以从 Hetzner云控制台.

Claude桌面配置

增添 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "hetzner": {
      "command": "bun",
      "args": ["run", "/path/to/mcp-hetzner/src/index.ts"],
      "env": {
        "HETZNER_API_TOKEN": "your-token-here"
      }
    }
  }
}

用法

运行服务器

# Start the server
bun run start

# Development mode with watch
bun run dev

MCP检验员测试

bun run inspect

可用工具

服务器管理

工具 说明
server_list 列出所有服务器
server_get 获取服务器详细信息
server_create 创建新服务器
server_delete 删除服务器
server_power_on 打开服务器电源
server_power_off 强制关闭电源
server_shutdown 优雅的关机
server_reboot 重新启动服务器
server_reset 强制重置
server_rebuild 使用新图像重建
server_change_type 更改服务器类型
server_enable_rescue 启用救援模式
server_disable_rescue 禁用救援模式

卷管理

工具 说明
volume_list 列出所有卷
volume_get 获取卷详细信息
volume_create 创建新卷
volume_delete 删除卷
volume_attach 连接到服务器
volume_detach 从服务器分离
volume_resize 调整音量大小

网络管理

工具 说明
network_list 列出所有网络
network_get 获取网络详细信息
network_create 创建新网络
network_delete 删除网络
network_add_subnet 添加子网
network_delete_subnet 删除子网
network_add_route 添加路线
network_delete_route 删除路线

防火墙管理

工具 说明
firewall_list 列出所有防火墙
firewall_get 获取防火墙详细信息
firewall_create 创建新防火墙
firewall_delete 删除防火墙
firewall_set_rules 设置防火墙规则
firewall_apply_to_resources 应用于服务器
firewall_remove_from_resources 从服务器中删除

SSH密钥管理

工具 说明
ssh_key_list 列出所有SSH密钥
ssh_key_get 获取SSH密钥详细信息
ssh_key_create 创建新的SSH密钥
ssh_key_delete 删除SSH密钥
ssh_key_update 更新SSH密钥

浮动IP管理

工具 说明
floating_ip_list 列出所有浮动IP
floating_ip_get 获取浮动IP详细信息
floating_ip_create 创建新的浮动IP
floating_ip_delete 删除浮动IP
floating_ip_assign 分配给服务器
floating_ip_unassign 从服务器取消分配
floating_ip_update 更新浮动IP

图像管理

工具 说明
image_list 列出所有图像
image_get 获取图像详细信息
image_update 更新图像
image_delete 删除图像

行动管理

工具 说明
action_get 获取操作状态
action_list 列出所有操作

可用资源

资源URI 描述
hetzner://server-types 可用的服务器类型及其规格和定价
hetzner://locations 数据中心位置
hetzner://datacenters 支持服务器类型的数据中心
hetzner://pricing 当前定价信息

发展

# Run linter
bun run lint

# Type check
bun run typecheck

# Run tests
bun test

许可证

麻省理工学院

相关 MCP