
Hetzner Cloud MCP Server

2025.04.10
5
Python云资源管理开发工具开发效率
Hetzner Cloud MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,用于与 Hetzner Cloud API 进行交互。该服务允许语言模型通过结构化函数管理 Hetzner Cloud 资源。
View on GitHub
Overview
基本能力
产品定位
Hetzner Cloud MCP Server 是一个用于管理 Hetzner Cloud 资源的中间件服务,通过 MCP 协议与语言模型交互,简化云资源管理操作。
核心功能
- 服务器管理:列出、创建、删除、启动、关闭和重启 Hetzner Cloud 服务器
- 存储卷管理:创建、删除、附加、分离和调整存储卷大小
- 防火墙管理:创建、更新、删除防火墙规则,并将其应用到服务器
- SSH 密钥管理:创建、更新、删除 SSH 密钥,用于安全访问服务器
- 资源信息查询:查看可用的镜像、服务器类型和位置信息
- Claude Code 集成:直接从 Claude Code 管理 Hetzner 资源
适用场景
- 云资源管理:自动化管理 Hetzner Cloud 上的服务器、存储卷和防火墙
- 开发与测试:快速创建和销毁测试环境
- 基础设施规划:查询可用资源信息,规划云基础设施
工具列表
- mcp-hetzner:主服务程序,支持 stdio 和 SSE 两种传输模式
- 测试客户端:用于验证服务器功能
常见问题解答
- 如何设置 API 令牌:在
.env
文件中设置HCLOUD_TOKEN
环境变量 - 如何更改端口:通过
--port
参数或设置MCP_PORT
环境变量 - 如何与 Claude Code 集成:使用 SSE 模式启动服务,然后连接 Claude Code
使用教程
使用依赖
- 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:作为包安装
pip install git+https://github.com/dkruyt/mcp-hetzner.git
调试方式
启动服务器
# 使用默认 stdio 传输
mcp-hetzner
# 使用 SSE 传输
mcp-hetzner --transport sse
# 设置自定义端口
mcp-hetzner --transport sse --port 8000
测试 API
python -m mcp_hetzner.client
与 Claude Code 集成
# 启动 SSE 模式的服务器
mcp-hetzner --transport sse --port 8080
# 在另一个终端连接 Claude Code
claude-code --mcp-server localhost:8080