hetzner について
hetznerは、Hetzner Cloud APIを通じてクラウドリソースを管理するMCPサーバーです。MCPクライアントからインフラを確認・操作したいユーザー向けで、全ツールまたは選択したリソースグループを起動できます。
主な機能
- 01サーバー、ネットワーク、ボリュームの管理
- 02ファイアウォール、DNS、ロードバランサーの管理
- 03リソース別のサーバーコマンド選択
- 04リソースとしてAPIリファレンスにアクセス
活用シーン
- 01MCPクライアントからHetzner Cloudのインフラを確認
- 02API操作によるクラウドリソースの作成と管理
- 03ネットワークなど特定のリソースグループだけを読み込み
MCP 対応
Hetzner Cloud APIの操作をMCPクライアントに公開し、クラウドリソースの管理に利用できます。stdio設定に対応し、`reference://hetzner/api`のAPIリファレンスリソースも提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y @lazyants/hetzner-mcp-serverHETZNER_API_TOKENシークレットHetzner Cloud API token.HETZNER_STORAGE_API_TOKENシークレットStorage Box API token; falls back to HETZNER_API_TOKEN when omitted.ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
185掲載時のツール一覧 · 5 日前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| name | string | いいえ | サーバー名で絞り込みます |
| page | integer | いいえ | ページ番号 |
| sort | any | いいえ | ソートフィールド。例:"id:asc" または "name:desc"。複数のソートフィールドを指定する場合は配列を渡します |
| status | enum | いいえ | サーバーのステータスで絞り込みますrunning | initializing | starting | stopping | off | deleting | migrating | rebuilding | unknown |
| per_page | integer | いいえ | 1 ページあたりの結果数(最大 50 件)。 |
| label_selector | string | いいえ | ラベルフィルター。例:"env=prod,tier=web" |
詳細
Hetzner MCP サーバー
MCP クライアントから Hetzner Cloud のサーバー、ネットワーク、ストレージ、DNS、ロードバランサーを管理します。 Node.js 22.12 以降が必要です。
セットアップ
Hetzner Cloud Consoleで API トークンを作成します。 確認には読み取り専用トークンを使用してください。書き込み操作では、料金が発生するリソースを作成できます。
Claude Codeの場合:
claude mcp add --env HETZNER_API_TOKEN=your-token --transport stdio \
hetzner -- npx -y @lazyants/hetzner-mcp-server
Claude Desktop および mcpServers JSON を受け付けるクライアントの場合:
{
"mcpServers": {
"hetzner": {
"command": "npx",
"args": ["-y", "@lazyants/hetzner-mcp-server"],
"env": { "HETZNER_API_TOKEN": "your-token" }
}
}
}
Storage Box 用に別のトークンを使用する場合は、HETZNER_STORAGE_API_TOKEN も設定してください。
設定しない場合、Storage Box ツールは HETZNER_API_TOKEN を使用します。
小規模なサーバー
デフォルトのコマンドでは、すべてのツールが公開されます。1 つのリソースグループだけを読み込むには、分割コマンドを実行します:
npx -y -p @lazyants/hetzner-mcp-server hetzner-mcp-networking
クライアント設定では、args を次のように置き換えます:
["-y", "-p", "@lazyants/hetzner-mcp-server", "hetzner-mcp-networking"]
その他のグループ:servers、load-balancers、ips、storage、storage-boxes、config、dns。
同じ hetzner-mcp- コマンドプレフィックスとトークン設定を使用してください。
すべてのサーバーで、reference://hetzner/api に API リファレンスが公開されています。
リリースの変更については、CHANGELOG.mdを参照してください。
リリース
メンテナー向けの手順:リリースガイド。
ライセンス
FSL-1.1-MIT。バージョン 1.1.1 以前は引き続き MIT ライセンスです。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。