Hetzner クラウド MCP サーバー
Hetzner Cloud APIと連携するためのモデルコンテキストプロトコル（MCP）サーバー。このサーバーにより、言語モデルは構造化された関数を通じてHetzner Cloudリソースを管理できるようになります。
特徴
- Hetzner Cloud サーバーの一覧表示、作成、管理
- ボリュームの作成、接続、切断、サイズ変更
- ファイアウォールルールを管理し、サーバーに適用する
- 安全なサーバーアクセスのための SSH キーの作成と管理
- 利用可能なイメージ、サーバーの種類、場所を表示します
- サーバーの電源オン/オフと再起動
- 言語モデルのインタラクションのためのシンプルで構造化された API
- Claude Code 統合により、Claude から直接 Hetzner リソースを管理できます。
要件
- Python 3.11以上
- Hetzner Cloud APIトークン
インストール
方法1：直接インストール
- このリポジトリをクローンします:
git clone https://github.com/dkruyt/mcp-hetzner.git
cd mcp-hetzner
- 依存関係をインストールします:
.envファイルを作成し、Hetzner Cloud API トークンを追加します。
HCLOUD_TOKEN=your_hetzner_cloud_api_token_here
方法2: パッケージとしてインストールする
# Install directly from the repository
pip install git+https://github.com/dkruyt/mcp-hetzner.git
パッケージとしてインストールした後、Hetzner Cloud API トークンを使用して作業ディレクトリに.envファイルを作成します。
使用法
サーバーの起動
オプション 1: インストールされたパッケージを実行します。
# Using default stdio transport
mcp-hetzner
# Using SSE transport
mcp-hetzner --transport sse
# Setting a custom port
mcp-hetzner --transport sse --port 8000
オプション 2: モジュールとして実行:
python -m mcp_hetzner
# or
python -m mcp_hetzner.server
サーバーは 2 つのトランスポート モードをサポートしています。
stdio (デフォルト): 標準I/Oトランスポート。通常はClaude Codeで使用される。sse : HTTPクライアントに適したServer-Sent Eventsトランスポート
デフォルトでは、サーバーはlocalhost:8080で実行されます。ホストとポートは次のようにカスタマイズできます。
.envファイルでMCP_HOSTおよびMCP_PORT環境変数を設定する--portコマンドライン引数を使用する (環境変数を上書きします)
Claude Codeと併用
Claude Code で使用するには、SSE トランスポートを使用してサーバーを実行します。
# Start the server with SSE transport
mcp-hetzner --transport sse --port 8080
# In another terminal, connect Claude Code to the server
claude-code --mcp-server localhost:8080
APIのテスト
サーバー機能を検証するためのテスト クライアントが含まれています。
python -m mcp_hetzner.client
ワークフローの例
基本的なサーバー管理
# List all your servers
list_servers
# Create a new server
create_server {
"name": "web-server",
"server_type": "cx11",
"image": "ubuntu-22.04"
}
# Power operations
power_off {"server_id": 12345}
power_on {"server_id": 12345}
reboot {"server_id": 12345}
# Delete a server when no longer needed
delete_server {"server_id": 12345}
ボリューム管理
# List all volumes
list_volumes
# Create a new volume
create_volume {
"name": "data-volume",
"size": 10,
"location": "nbg1",
"format": "ext4"
}
# Attach volume to a server
attach_volume {
"volume_id": 12345,
"server_id": 67890,
"automount": true
}
# Detach volume from server
detach_volume {
"volume_id": 12345
}
# Resize a volume (can only increase size)
resize_volume {
"volume_id": 12345,
"size": 50
}
# Delete a volume when no longer needed
delete_volume {
"volume_id": 12345
}
ファイアウォール管理
# List all firewalls
list_firewalls
# Create a firewall for web servers
create_firewall {
"name": "web-firewall",
"rules": [
{
"direction": "in",
"protocol": "tcp",
"port": "80",
"source_ips": ["0.0.0.0/0", "::/0"]
},
{
"direction": "in",
"protocol": "tcp",
"port": "443",
"source_ips": ["0.0.0.0/0", "::/0"]
}
]
}
# Apply firewall to a server
apply_firewall_to_resources {
"firewall_id": 12345,
"resources": [
{
"type": "server",
"server_id": 67890
}
]
}
SSHキー管理
# List all SSH keys
list_ssh_keys
# Create a new SSH key
create_ssh_key {
"name": "my-laptop",
"public_key": "ssh-rsa AAAAB3NzaC1yc2EAAA... user@laptop"
}
# Use the SSH key when creating a server
create_server {
"name": "secure-server",
"server_type": "cx11",
"image": "ubuntu-22.04",
"ssh_keys": [12345]
}
# Update an SSH key's name
update_ssh_key {
"ssh_key_id": 12345,
"name": "work-laptop"
}
# Delete an SSH key
delete_ssh_key {
"ssh_key_id": 12345
}
インフラ計画
# Explore available resources
list_server_types
list_images
list_locations
# Get specific server information
get_server {"server_id": 12345}
利用可能な機能
MCP サーバーは次の機能を提供します。
サーバー管理
list_servers : Hetzner Cloud アカウント内のすべてのサーバーを一覧表示しますget_server : 特定のサーバーの詳細を取得するcreate_server : 新しいサーバーを作成するdelete_server : サーバーを削除するpower_on : サーバーの電源をオンにするpower_off : サーバーの電源をオフにするreboot : サーバーを再起動する
ボリューム管理
list_volumes : Hetzner Cloud アカウント内のすべてのボリュームを一覧表示しますget_volume : 特定のボリュームの詳細を取得するcreate_volume : 新しいボリュームを作成するdelete_volume : ボリュームを削除するattach_volume : ボリュームをサーバーに接続するdetach_volume : サーバーからボリュームを切り離すresize_volume : ボリュームのサイズを増やす
ファイアウォール管理
list_firewalls : Hetzner Cloud アカウント内のすべてのファイアウォールを一覧表示しますget_firewall : 特定のファイアウォールの詳細を取得するcreate_firewall : 新しいファイアウォールを作成するupdate_firewall : ファイアウォールの名前またはラベルを更新するdelete_firewall : ファイアウォールを削除するset_firewall_rules : ファイアウォールルールを設定または更新するapply_firewall_to_resources : サーバーまたはサーバーグループにファイアウォールを適用するremove_firewall_from_resources : サーバーまたはサーバーグループからファイアウォールを削除します
SSHキー管理
list_ssh_keys : Hetzner Cloud アカウント内のすべての SSH キーを一覧表示しますget_ssh_key : 特定のSSHキーの詳細を取得するcreate_ssh_key : 新しいSSHキーを作成するupdate_ssh_key : SSHキー名またはラベルを更新するdelete_ssh_key : SSHキーを削除する
情報
list_images : 利用可能な OS イメージを一覧表示するlist_server_types : 利用可能なサーバーの種類を一覧表示するlist_locations : 利用可能なデータセンターの場所を一覧表示する
ライセンス
マサチューセッツ工科大学