mcp-hetzner

MCP Hetzner Go

Hetzner Cloud API と連携するための Go 製 Model Context Protocol（MCP）サーバーです。

🌟 注目

🎉 公式の Awesome HCloud リストに掲載されました！

Claude Desktop での使用

次の内容で ~/Library/Application Support/Claude/claude_desktop_config.json ファイルを作成します。

{
  "mcpServers": {
    "hetzner": {
      "command": "<your path to golang MCP server go executable>",
      "env": {
        "HCLOUD_TOKEN": "YOUR-HCLOUD-TOKEN"
      }
    }
  }
}

🛠 クライアントのビルド

npm --prefix ./client i
npm --prefix ./client run build

🖥 サーバーのビルド

go mod init github.com/MahdadGhasemian/mcp-hetzner-go
go mod tidy
go build -o mcphetzner
# go run .

🚀 クライアントの実行

node ./client/build/index.js ./mcphetzner

⚠️ 使用上の制限

サーバーは、設定で制御される次の 2 つの操作モードをサポートしています。

• 読み取り専用モード：GET および LIST 操作のみを許可します。
• 読み書きモード：GET、LIST、CREATE/UPDATE/DELETE 操作を許可します。

デフォルトでは、サーバーは読み取り専用モードで起動します。
リソースの作成、更新、削除などの書き込み操作を有効にするには、設定フラグを明示的に指定して読み書きモードを有効にする必要があります。

警告：書き込みモードを有効にすると、クライアントが Hetzner Cloud リソースを変更できるようになります。
その影響を理解し、適切なアクセス制御を設定してください。

モードの切り替え

設定を編集するか、起動時に該当する環境変数／フラグを渡します。

• 読み取り専用（デフォルト。確認や監視に安全です）：

  ./mcphetzner --restriction=read_only
  

• 読み書き（注意して使用してください）：

  ./mcphetzner --restriction=read_write
  

✅ Lint

# install golangci-lint and then run:
golangci-lint run

🔍 Inspector

npx @modelcontextprotocol/inspector

🗺 ロードマップ

• 次のすべての GET および LIST 操作を実装：

  • 証明書
  • SSH キー
  • ロケーション
  • データセンター
  • ファイアウォール
  • フローティング IP
  • サーバー
  • イメージ
  • ISO
  • プレースメントグループ
  • プライマリ IP
  • サーバータイプ
  • ロードバランサー
  • ロードバランサータイプ
  • ネットワーク
  • ボリューム
  • 料金

• 次を行う設定フラグまたは設定を追加：

  • 読み取り専用モードを有効化（GET/LIST のみ）
  • 読み書きモードを有効化（GET/LIST + CREATE/UPDATE/DELETE）

• 書き込み操作（作成／更新）を実装：

  • 証明書
  • SSH キー
  • ファイアウォール
  • フローティング IP
  • サーバー
  • イメージ
  • プレースメントグループ
  • プライマリ IP
  • ロードバランサー
  • ネットワーク
  • ボリューム

• 対応するリソースの削除機能を追加