Hetzner Cloud MCP Server

Hetzner Cloud MCP Server

site icon
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

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。