🚀 Hetzner Cloud MCP 服务器指南
Hetzner Cloud MCP 服务器是用于与 Hetzner 云 API 交互的模型上下文协议 (MCP) 服务器。它借助结构化函数，让语言模型能够管理 Hetzner 云资源。
🚀 快速开始
Hetzner Cloud MCP 服务器可让语言模型管理 Hetzner 云资源。启动服务器后，客户端能通过 HTTP 或 gRPC 协议与其通信。
✨ 主要特性
- 服务器管理：支持列出、创建、删除、启动、关闭和重启服务器。
- 存储卷管理：支持列出、创建、删除、挂载和卸载存储卷，以及调整存储卷大小。
- 防火墙管理：支持列出、创建、更新、删除防火墙规则，并将防火墙应用于服务器或服务器组。
- SSH 密钥管理：支持列出、创建、更新和删除 SSH 密钥。
- 资源信息：提供可用操作系统镜像、服务器类型和数据中心位置的信息。
📦 安装指南
安装要求
- Python 版本：需要 Python 3.11 或更高版本。
- API 凭证：需要 Hetzner Cloud API 令牌以进行身份验证。
安装步骤
方法一：直接安装
- 克隆代码仓库：
git clone https://github.com/your-repository.git
cd your-repository
- 安装依赖项：
pip install -r requirements.txt
- 创建配置文件：
- 在项目根目录下创建一个
.env文件，并添加以下内容：
HETZNER_TOKEN=your_api_token_here
- 启动服务器：
python main.py
方法二：使用 pip 安装
- 使用 pip 直接安装：
pip install your-package-name
-
创建配置文件
.env，内容同上。 -
启动服务器：
your-package-name start
💻 使用示例
基础用法
运行 MCP 服务器
- 启动服务器后，它将在指定端口（默认为
8000）上运行。 - 客户端可以通过 HTTP 或 gRPC 协议与服务器进行通信。
高级用法
支持的功能
服务器管理
list_servers：列出所有服务器。get_server：获取特定服务器的详细信息。create_server：创建新服务器。delete_server：删除服务器。power_on：启动服务器。power_off：关闭服务器。reboot：重启服务器。
存储卷管理
list_volumes：列出所有存储卷。get_volume：获取特定存储卷的详细信息。create_volume：创建新存储卷。delete_volume：删除存储卷。attach_volume：将存储卷挂载到服务器。detach_volume：从服务器卸载存储卷。resize_volume：调整存储卷大小。
防火墙管理
list_firewalls：列出所有防火墙规则。get_firewall：获取特定防火墙的详细信息。create_firewall：创建新防火墙规则。update_firewall：更新防火墙名称或标签。delete_firewall：删除防火墙规则。set_firewall_rules：设置或更新防火墙规则。apply_firewall_to_resources：将防火墙应用于服务器或服务器组。remove_firewall_from_resources：从服务器或服务器组中移除防火墙。
SSH 密钥管理
list_ssh_keys：列出所有 SSH 密钥。get_ssh_key：获取特定 SSH 密钥的详细信息。create_ssh_key：创建新 SSH 密钥。update_ssh_key：更新 SSH 密钥名称或标签。delete_ssh_key：删除 SSH 密钥。
资源信息
list_images：获取可用操作系统镜像列表。list_types：获取可用服务器类型列表。list_locations：获取可用数据中心位置列表。
📄 许可证
本项目遵循 MIT 协议开源，允许自由使用和修改，但需保留版权声明。