de en es ja ko ru zh

Hetzner Cloud MCP Server — Cloud API + SSH management (60 tools)

Name: Hetzner Cloud MCP Server — Cloud API + SSH management (60 tools)
Author: wbf-solutions

by wbf-solutions

Overview Schema Source Related Servers Discussions Admin

Remote

Hetzner Cloud MCP 服务器

唯一支持 SSH 服务器管理的 Hetzner MCP。API + SSH 集于一身。

PHP 8.1+ License: MIT MCP Protocol

通过 Claude.ai、Claude Desktop、VS Code、Cursor 或任何兼容 MCP 的客户端管理您的 Hetzner Cloud 基础设施。最棒的是，您可以使用手机上的 Claude、ChatGPT 或任何其他 AI 聊天应用来控制服务器并构建任何内容。两个管理层为您提供完全控制权：

第 1 层 — Hetzner Cloud API： 服务器电源、指标、快照、备份、防火墙、DNS 区域和记录、救援模式、服务器重建和调整大小。即使服务器操作系统无响应也能工作。
第 2 层 — SSH： 服务、日志、Nginx、MySQL、supervisor、cron、UFW、磁盘/内存/CPU 监控。真正的系统管理员工具，而不仅仅是 API 包装器。

60 个工具。动态多服务器配置。自托管且开源。

为什么选择此 MCP？

现有的每个 Hetzner MCP 都只是封装了 Cloud API。此版本增加了一个完整的 SSH 管理层——这是您在管理生产服务器时真正需要的工具。两层架构，60 个工具，支持自托管。

功能	已包含
Cloud API (服务器电源、指标、快照、备份、防火墙、救援、重建)	是
SSH 管理 (服务、日志、Nginx、MySQL、系统健康状况)	是
DNS 管理 (区域、记录、CRUD)	是
多服务器 (单个实例管理 1 到 N 台服务器)	是
破坏性操作防护 (危险操作需要确认)	是
传输协议	SSE + 可流式传输 HTTP
语言	PHP 8.1+

Related MCP server: hcloud-mcp

快速入门

先决条件

PHP 8.1+，带有 curl 扩展
Composer
Hetzner Cloud API 令牌 (控制台 > 安全 > API 令牌)
用于服务器访问的 SSH 密钥（第 2 层工具）

1. 克隆并安装

git clone https://github.com/wbf-solutions/hetzner-cloud-mcp.git
cd hetzner-cloud-mcp
composer install

2. 配置

cp .env.example .env

编辑 .env 文件并填入您的详细信息：

HETZNER_API_TOKEN=your-cloud-api-token

SERVERS=web
SERVER_WEB_ID=12345678
SERVER_WEB_IP=1.2.3.4
SERVER_WEB_SSH_USER=root

SSH_KEY_PATH=/root/.ssh/id_ed25519

MCP_API_KEY=your-random-key    # generate with: openssl rand -hex 32

3. 设置 SSH 密钥

ssh-keygen -t ed25519 -f /root/.ssh/id_ed25519 -N ""
ssh-copy-id -i /root/.ssh/id_ed25519.pub root@1.2.3.4

4. 配置 Nginx

server {
    listen 443 ssl;
    server_name mcp.yourdomain.com;

    ssl_certificate /etc/letsencrypt/live/mcp.yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/mcp.yourdomain.com/privkey.pem;

    root /var/www/hetzner-cloud-mcp;
    index api.php;

    location / {
        try_files $uri /api.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
        fastcgi_buffering off;
        fastcgi_read_timeout 600;
    }
}

5. 连接到 Claude.ai

设置 > 连接器 > 添加自定义连接器：

名称： Hetzner Cloud MCP
URL： https://mcp.yourdomain.com/api.php

如果您设置了 MCP_API_KEY，请通过 URL 传递：?mcp=sse&key=YOUR_MCP_API_KEY 或者在连接器的高级设置中将 API 密钥配置为 Bearer 令牌。

可用工具 (60)

第 1 层 — Hetzner Cloud API (25 个工具)

工具	描述	破坏性
`server_info`	服务器详情：状态、IP、类型、数据中心
`server_metrics`	CPU、磁盘或网络指标
`server_power_on`	开机
`server_power_off`	强制关机	确认
`server_shutdown`	优雅的 ACPI 关机
`server_reboot`	软重启
`server_reset`	强制重置	确认
`server_reset_password`	重置 root 密码	确认
`server_rescue_enable`	启用救援模式
`server_rescue_disable`	禁用救援模式
`server_rebuild`	从镜像重建（清除数据）	确认
`server_change_type`	调整服务器方案	确认
`snapshot_create`	创建快照
`snapshot_list`	列出快照
`snapshot_delete`	删除快照	确认
`backup_enable`	启用备份 (+20% 成本)
`backup_disable`	禁用备份	确认
`firewall_list`	列出防火墙
`firewall_get`	获取防火墙规则
`firewall_set_rules`	替换所有防火墙规则	确认
`firewall_apply_to_server`	将防火墙应用到服务器
`firewall_remove_from_server`	从服务器移除防火墙
`project_servers_list`	列出所有服务器
`ssh_keys_list`	列出 SSH 密钥
`action_status`	检查异步操作状态

DNS (8 个工具，需要 `HETZNER_DNS_TOKEN`)

工具	描述	破坏性
`dns_zones_list`	列出 DNS 区域
`dns_zone_get`	获取区域详情
`dns_zone_create`	创建 DNS 区域
`dns_zone_delete`	删除 DNS 区域	确认
`dns_records_list`	列出区域中的记录
`dns_record_add`	添加 DNS 记录
`dns_record_update`	更新 DNS 记录
`dns_record_delete`	删除 DNS 记录	确认

第 2 层 — SSH (27 个工具)

工具	描述
`ssh_service_status`	检查 systemd 服务状态
`ssh_service_start`	启动服务
`ssh_service_stop`	停止服务
`ssh_service_restart`	重启服务
`ssh_services_list`	列出正在运行的服务
`ssh_disk_usage`	磁盘空间 (`df -h`)
`ssh_memory_usage`	内存使用情况 (`free -h`)
`ssh_cpu_load`	CPU 负载 + 顶级进程
`ssh_process_list`	按内存/CPU 排序的进程列表
`ssh_uptime`	服务器运行时间
`ssh_nginx_test`	测试 Nginx 配置语法
`ssh_nginx_reload`	重载 Nginx (先进行测试)
`ssh_nginx_sites_list`	列出已启用的站点
`ssh_nginx_site_config`	查看站点 Nginx 配置
`ssh_logs_nginx_error`	跟踪 Nginx 错误日志
`ssh_logs_nginx_access`	跟踪 Nginx 访问日志
`ssh_logs_syslog`	跟踪系统日志
`ssh_logs_journal`	查看 systemd 日志
`ssh_logs_supervisor`	查看 supervisor 日志
`ssh_mysql_databases`	列出 MySQL 数据库
`ssh_mysql_processlist`	显示 MySQL 进程
`ssh_mysql_query`	只读 SQL 查询
`ssh_cron_list`	列出 crontab 条目
`ssh_supervisor_status`	Supervisor 程序状态
`ssh_supervisor_restart`	重启 Supervisor 程序
`ssh_ufw_status`	检查 UFW 防火墙
`ssh_exec`	运行命令 (已屏蔽危险命令)

身份验证

选择适合您部署的模式：

模式	配置	适用场景
无认证	`MCP_API_KEY=` (空), 无 `OAUTH_*`	VPN/防火墙后，本地开发
API 密钥	`MCP_API_KEY=your-key`	自托管，单用户/团队
API 密钥 + OAuth	设置 `MCP_API_KEY` + `OAUTH_*` 变量	多用户，连接器目录

API 密钥（推荐用于自托管）

生成一个密钥并将其设置在 .env 中：

openssl rand -hex 32

客户端通过 ?key=XXX 或 Authorization: Bearer XXX 传递密钥。

OAuth 2.1 (可选)

对于高级部署或提交到 Anthropic 连接器目录，您可以添加 OAuth 2.1 令牌自省功能。这需要一个带有自省端点 (RFC 7662) 的外部 OAuth 授权服务器。有关 OAUTH_* 变量，请参阅 .env.example。

安全性

身份验证： 通过查询参数或 Authorization: Bearer 标头进行 API 密钥验证。可选 OAuth 2.1 自省。定时安全验证。
破坏性防护： 所有危险操作都需要 confirm=true。
工具注释： 所有工具均根据 MCP 规范包含 readOnlyHint 和 destructiveHint。
SSH 安全： 屏蔽了 29 种命令模式 (rm -rf, dd, mkfs, curl|sh, passwd, fdisk 等)。
只读 SQL： 仅允许 SELECT, SHOW, DESCRIBE, EXPLAIN。
速率限制： 使用原子 flock() 进行基于 IP 的限制。

配置

在 .env 中定义任意数量的服务器：

SERVERS=web,staging
SERVER_WEB_ID=12345678
SERVER_WEB_IP=1.2.3.4
SERVER_WEB_SSH_USER=root
SERVER_WEB_ALIASES=production,prod
SERVER_STAGING_ID=87654321
SERVER_STAGING_IP=5.6.7.8
DEFAULT_SERVER=web

SSH 和 DNS 是可选的 — 未配置时工具会自动禁用。

有关完整参考，请参阅 .env.example。

客户端配置

客户端	连接
Claude.ai	设置 > 连接器 > 添加带有 SSE URL 的自定义连接器
Claude Desktop	添加到 `claude_desktop_config.json`
Claude Code	`claude mcp add --transport http hetzner URL --header "Authorization: Bearer KEY"`
VS Code / Cursor	VS Code 扩展 — 即将推出

部署

适用于 VitoDeploy 或手动 Nginx + PHP-FPM 设置。需要 fastcgi_buffering off 以支持 SSE 流式传输。请参阅快速入门部分中的完整部署指南。

贡献

请参阅 CONTRIBUTING.md。安全漏洞请联系：labs@wbf.solutions。

链接

落地页： hetzner-cloud-mcp.wbf.tools
构建者： WBF Solutions
联系方式： labs@wbf.solutions

许可证

MIT — WBF Solutions | labs@wbf.solutions

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessSyncing

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

hostinger-api-mcpOAuth
io.github.hostinger
MCP server for Hostinger API
Cloud Platforms Developer Tools
1154
mcp-server
io.github.hostkey-cloud
MCP server for Hostkey .com (InvAPI): servers, power, order, DNS, S3, billing
Cloud Platforms Cloud Storage Payments & Billing
1
Os Automation Mcp C
io.github.varvararatta
MCP server for OS Automation
OS Automation Command Line
2
SevallaOAuth
io.github.sevalla-hosting
Official Sevalla MCP — full PaaS API access through just 2 tools.
Cloud Platforms Developer Tools
28

Related MCP Servers

Hetzner Cloud MCP Server
Cloud Platforms Shell Access
dkruyt
A
license
A
quality
D
maintenance
A Model Context Protocol server that allows language models to manage Hetzner Cloud resources through structured functions, including servers, volumes, firewalls, and SSH keys.
Updated a year ago (2025-04-10 07:58 UTC)
30
140
MIT
hcloud-mcp
Cloud Platforms Virtualization
Xodus-CO
A
license
C
quality
D
maintenance
A Model Context Protocol server for the Hetzner Cloud API that enables natural language management of cloud infrastructure. Users can list, create, and modify servers, networks, volumes, and load balancers through MCP-compatible clients.
Updated 7 months ago (2026-02-19 17:01 UTC)
67
36 npm
MIT
mcp-hetzner
Cloud Platforms Networking & Infrastructure Cloud Storage
ginkelsoft-development
A
license
B
quality
D
maintenance
Enables conversational management of Hetzner Cloud, DNS, and Storage Box infrastructure through 137 MCP tools for CRUD operations and actions like server power control, DNS zone management, and storage box snapshots.
Updated 4 months ago (2026-05-26 14:24 UTC)
100
MIT
hetzner-mcp
Cloud Platforms Networking & Infrastructure
devinoldenburg
A
license
Not graded
quality
A
maintenance
Model Context Protocol server for full Hetzner Cloud + Storage API automation. Exposes all official Hetzner operations as MCP tools so AI agents can manage servers, networking, load balancers, firewalls, volumes, DNS zones, and storage boxes from one server.
Updated 4 months ago (2026-05-25 05:34 UTC)
1
MIT