mcpField
H
hetzner

hetzner

ローカル
github.com/lazyantsクラウド・インフラ55 日前に更新

hetzner について

hetznerは、Hetzner Cloud APIを通じてクラウドリソースを管理するMCPサーバーです。MCPクライアントからインフラを確認・操作したいユーザー向けで、全ツールまたは選択したリソースグループを起動できます。

主な機能

  1. 01サーバー、ネットワーク、ボリュームの管理
  2. 02ファイアウォール、DNS、ロードバランサーの管理
  3. 03リソース別のサーバーコマンド選択
  4. 04リソースとしてAPIリファレンスにアクセス

活用シーン

  1. 01MCPクライアントからHetzner Cloudのインフラを確認
  2. 02API操作によるクラウドリソースの作成と管理
  3. 03ネットワークなど特定のリソースグループだけを読み込み

MCP 対応

Hetzner Cloud APIの操作をMCPクライアントに公開し、クラウドリソースの管理に利用できます。stdio設定に対応し、`reference://hetzner/api`のAPIリファレンスリソースも提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"lazyants-hetzner": {
"command": "npx",
"args": [
"-y",
"@lazyants/hetzner-mcp-server"
],
"env": {
"HETZNER_API_TOKEN": "<HETZNER_API_TOKEN>",
"HETZNER_STORAGE_API_TOKEN": "<HETZNER_STORAGE_API_TOKEN>"
}
}
}
}
起動コマンドnpx -y @lazyants/hetzner-mcp-server
設定が必要な環境変数
HETZNER_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 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@lazyants/hetzner-mcp-server4.0.2

ツール

185

掲載時のツール一覧 · 5 日前に更新

パラメーター型必須説明
namestringいいえサーバー名で絞り込みます
pageintegerいいえページ番号
sortanyいいえソートフィールド。例:"id:asc" または "name:desc"。複数のソートフィールドを指定する場合は配列を渡します
statusenumいいえサーバーのステータスで絞り込みますrunning | initializing | starting | stopping | off | deleting | migrating | rebuilding | unknown
per_pageintegerいいえ1 ページあたりの結果数(最大 50 件)。
label_selectorstringいいえラベルフィルター。例:"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 ライセンスです。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。