MCP Hetzner

🚀 Hetzner Cloud MCP サーバーガイド

Hetzner Cloud MCP サーバーは、Hetzner クラウド API とのインタラクションを可能にするモデルコンテキストプロトコル (MCP) サーバーです。言語モデルが構造化された関数を通じて Hetzner クラウドリソースを管理できるようにすることが目的です。

🚀 クイックスタート

Hetzner Cloud MCP サーバーを使い始めるには、まずインストールを行い、その後サーバーを起動します。以下のセクションで詳細を説明します。

✨ 主な機能

• サーバー管理：サーバーの一覧表示、作成、削除、起動、停止、再起動をサポートします。
• ストレージボリューム管理：ストレージボリュームの一覧表示、作成、削除、マウント、アンマウント、サイズ調整をサポートします。
• ファイアウォール管理：ファイアウォールルールの一覧表示、作成、更新、削除、およびサーバーまたはサーバーグループへの適用をサポートします。
• 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 ライセンスの下で公開されており、自由に使用および変更できますが、著作権表示を保持する必要があります。