mcp-hetzner

🚀 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 令牌以进行身份验证。

安装步骤

方法一：直接安装

1. 克隆代码仓库：

git clone https://github.com/your-repository.git
cd your-repository

2. 安装依赖项：

pip install -r requirements.txt

3. 创建配置文件：

• 在项目根目录下创建一个 .env 文件，并添加以下内容：

HETZNER_TOKEN=your_api_token_here

4. 启动服务器：

python main.py

方法二：使用 pip 安装

1. 使用 pip 直接安装：

pip install your-package-name

2. 创建配置文件 .env，内容同上。

3. 启动服务器：

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 协议开源，允许自由使用和修改，但需保留版权声明。