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 協議開源，允許自由使用和修改，但需保留版權聲明。