35 MCP Tools / Vercel + Cloudflare Tunnel

AIでProxmoxクラスタを
完全リモート操作する

VM・コンテナ・ストレージ・スナップショット。Proxmox VEの全操作をAIとの会話で完結。Vercelにデプロイし、Cloudflare Tunnel経由でローカルクラスタに接続。

ENDPOINT https://proxmox-mcp-server.vercel.app/api/mcp
35
MCP Tools
583
テスト (全パス)
2層
認証セキュリティ
4
対応クライアント
⬡ FEATURES

なにができるのか

「コンテナ3台作って」「スナップショット撮って」「メモリ逼迫してるノードどこ?」— インフラ操作をAIに任せる。

🖥️

VM & コンテナ管理

QEMU VM 7ツール + LXC 11ツール。作成・クローン・起動・停止・設定変更・削除まで全ライフサイクルをカバー。テンプレートからの一括デプロイも会話で完結。

📸

スナップショット & ロールバック

VM/コンテナ問わずスナップショットの作成・一覧・ロールバック・削除。「アップデート前にスナップ撮って」→「問題あったから戻して」を自然言語で。

📊

クラスタ監視 & タスク追跡

ノードのCPU/メモリ/ディスク状態をリアルタイム取得。非同期タスク(作成・クローン・バックアップ)のUPIDを追跡してログを確認。

🔌

汎用APIアクセス

proxmox_api_request で35ツールでカバーされない任意のAPIエンドポイントにアクセス。QEMUエージェント・ファイアウォール・Ceph管理も。

☁️

Cloudflare Tunnel統合

ポート開放不要。Cloudflare Tunnelでローカルクラスタを安全にインターネット公開。自己署名証明書にも対応(noTLSVerify)。

🔐

2層セキュリティ

MCPレイヤーでAPIキー認証 + ProxmoxレイヤーでPVE APIトークン認証。ステートレスでトークン保存なし。全通信TLS暗号化。

⬡ ARCHITECTURE

アーキテクチャ

MCPクライアント → Vercel → Cloudflare Tunnel → Proxmox VE。完全リモートでローカルクラスタを操作。

  Claude.ai / Desktop / Cursor
          │
          │ MCP (Streamable HTTP / SSE)
          │ ?key=<MCP_API_KEY>Vercel (proxmox-mcp-server)
  Next.js + mcp-handler / 35 Tools
          │
          │ HTTPS (PVEAPIToken)
          ▼
  Cloudflare Tunnel
  vm.appserver.tokyo → 192.168.70.226:8006
          │
          │ LAN
          ▼
  Proxmox VE Cluster
  4 Nodes / 60 Cores / 501 GiB RAM
  
⬡ 35 TOOLS

ツール一覧

Proxmox VE APIの主要操作を35ツールでカバー。全ツールにReadOnly/Destructiveアノテーション付き。

クラスタ & ノード (4)

ツール説明R/W
cluster_statusクラスタ全体のステータス・クォーラムR
cluster_resources全リソース一覧(VM/CT/Storage/Node)R
list_nodes全ノード(CPU%/メモリ/稼働時間)R
node_statusノード詳細(カーネル/CPU/ディスク)R

QEMU VM (7)

ツール説明R/W
list_vmsVM一覧R
vm_statusリアルタイムステータスR
vm_configCPU/メモリ/ディスク/NIC設定R
vm_startVM起動W
vm_stop強制停止(電源断)⚠️
vm_shutdownグレースフルシャットダウンW
vm_reboot再起動W

LXCコンテナ (11)

ツール説明R/W
list_containersコンテナ一覧R
container_statusリアルタイムステータスR
container_config設定取得R
container_start起動W
container_stop強制停止⚠️
container_shutdownグレースフルシャットダウンW
container_reboot再起動W
create_container新規作成(テンプレート指定)W
clone_containerクローンW
delete_container削除(confirm必須)⚠️
update_container_config設定変更W

ストレージ / スナップショット / タスク / その他 (13)

ツール説明R/W
list_storagesストレージ一覧R
storage_contentISO/テンプレート/バックアップ一覧R
list_snapshotsスナップショット一覧R
create_snapshotスナップショット作成W
rollback_snapshotロールバック⚠️
delete_snapshotスナップショット削除⚠️
list_tasksタスク一覧R
task_statusタスクステータスR
task_logタスクログR
list_networksネットワーク一覧R
list_templatesOSテンプレート一覧R
download_templateテンプレートDLW
api_request汎用API(任意のエンドポイント)R/W
⬡ QUICK START

3ステップで接続

1. APIトークン作成

Proxmox Web UI → Datacenter → Permissions → API Tokens → Add。Privilege Separationはオフ。

2. Cloudflare Tunnel

Proxmox APIポート(8006)をCloudflare Tunnelで公開。noTLSVerify: trueで自己署名証明書対応。

3. MCP接続

Claude.ai → Settings → Connect Apps → Add Integration にエンドポイントURLを入力。

Claude.ai (Web)

https://proxmox-mcp-server.vercel.app/api/mcp?key=YOUR_MCP_API_KEY

Claude Desktop / Cursor / VS Code

{ "mcpServers": { "proxmox": { "command": "npx", "args": ["-y", "mcp-remote", "https://proxmox-mcp-server.vercel.app/api/mcp"], "env": { "HEADER_Authorization": "Bearer YOUR_MCP_API_KEY" } } } }
⬡ SECURITY

セキュリティ設計

ポート開放不要

Cloudflare Tunnel経由。Proxmoxサーバーへの直接アクセスは不可。外部からのポートスキャンも無効。

2層認証

MCPレイヤーでAPIキー認証 + ProxmoxレイヤーでPVE APIトークン。どちらか一方が漏洩しても不正操作不可。

ステートレス

サーバーにDBなし。トークンはVercel環境変数で管理。リクエスト処理中にのみ使用。ログ出力なし。

全通信TLS暗号化

Claude → Vercel → Cloudflare → Proxmox。全経路がHTTPS。平文通信は一切なし。

今すぐ始める

Proxmoxクラスタをお持ちなら、5分で接続できます。

GitHub → Deploy with Vercel

関連 MCP サーバー

堀が公開している MCP サーバー群。すべて Claude.ai / Cursor 等から利用可能。

サーバーツール説明
b2cloud-api14ヤマト B2クラウド送り状発行 API/MCP
cloudflare-mcp69Cloudflare 統合(Tunnel/DNS/Workers/Pages/R2/KV/SSL/Access)
hubspot-ma-mcp128HubSpot MA(CRM/Marketing/Knowledge Store)
msgraph-mcp-server48Microsoft Graph API(Exchange/Teams/OneDrive/SharePoint)
playwright-devtools-mcp57Playwright + Chrome DevTools(ブラウザ自動化)
proxmox-mcp-server ← 今ここ35Proxmox VE 仮想化基盤操作
printer-mcp-serverCUPS ネットワークプリンタ制御(Kyocera TASKalfa)
yamato-printer-mcp-serverヤマト送り状サーマルプリンタ(ラズパイ + WS-420B)
ssh-mcp-server10SSH クライアント(セッション管理/非同期コマンド)
mac-remote-mcp34macOS リモート制御(Shell/GUI/ファイル/アプリ)
gemini-image-mcp4Gemini/Imagen 画像生成
runpod-mcp36RunPod GPU FaaS(Pods/Endpoints/Jobs)
firecrawl-mcpFirecrawl セルフホスト Web スクレイピング
ad-ops-mcp62広告運用自動化(Google Ads/Meta/GBP/X)