VM・コンテナ・ストレージ・スナップショット。Proxmox VEの全操作をAIとの会話で完結。Vercelにデプロイし、Cloudflare Tunnel経由でローカルクラスタに接続。
「コンテナ3台作って」「スナップショット撮って」「メモリ逼迫してるノードどこ?」— インフラ操作をAIに任せる。
QEMU VM 7ツール + LXC 11ツール。作成・クローン・起動・停止・設定変更・削除まで全ライフサイクルをカバー。テンプレートからの一括デプロイも会話で完結。
VM/コンテナ問わずスナップショットの作成・一覧・ロールバック・削除。「アップデート前にスナップ撮って」→「問題あったから戻して」を自然言語で。
ノードのCPU/メモリ/ディスク状態をリアルタイム取得。非同期タスク(作成・クローン・バックアップ)のUPIDを追跡してログを確認。
proxmox_api_request で35ツールでカバーされない任意のAPIエンドポイントにアクセス。QEMUエージェント・ファイアウォール・Ceph管理も。
ポート開放不要。Cloudflare Tunnelでローカルクラスタを安全にインターネット公開。自己署名証明書にも対応(noTLSVerify)。
MCPレイヤーでAPIキー認証 + ProxmoxレイヤーでPVE APIトークン認証。ステートレスでトークン保存なし。全通信TLS暗号化。
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
Proxmox VE APIの主要操作を35ツールでカバー。全ツールにReadOnly/Destructiveアノテーション付き。
| ツール | 説明 | R/W |
|---|---|---|
cluster_status | クラスタ全体のステータス・クォーラム | R |
cluster_resources | 全リソース一覧(VM/CT/Storage/Node) | R |
list_nodes | 全ノード(CPU%/メモリ/稼働時間) | R |
node_status | ノード詳細(カーネル/CPU/ディスク) | R |
| ツール | 説明 | R/W |
|---|---|---|
list_vms | VM一覧 | R |
vm_status | リアルタイムステータス | R |
vm_config | CPU/メモリ/ディスク/NIC設定 | R |
vm_start | VM起動 | W |
vm_stop | 強制停止(電源断) | ⚠️ |
vm_shutdown | グレースフルシャットダウン | W |
vm_reboot | 再起動 | W |
| ツール | 説明 | 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 |
| ツール | 説明 | R/W |
|---|---|---|
list_storages | ストレージ一覧 | R |
storage_content | ISO/テンプレート/バックアップ一覧 | R |
list_snapshots | スナップショット一覧 | R |
create_snapshot | スナップショット作成 | W |
rollback_snapshot | ロールバック | ⚠️ |
delete_snapshot | スナップショット削除 | ⚠️ |
list_tasks | タスク一覧 | R |
task_status | タスクステータス | R |
task_log | タスクログ | R |
list_networks | ネットワーク一覧 | R |
list_templates | OSテンプレート一覧 | R |
download_template | テンプレートDL | W |
api_request | 汎用API(任意のエンドポイント) | R/W |
Proxmox Web UI → Datacenter → Permissions → API Tokens → Add。Privilege Separationはオフ。
Proxmox APIポート(8006)をCloudflare Tunnelで公開。noTLSVerify: trueで自己署名証明書対応。
Claude.ai → Settings → Connect Apps → Add Integration にエンドポイントURLを入力。
https://proxmox-mcp-server.vercel.app/api/mcp?key=YOUR_MCP_API_KEY{
"mcpServers": {
"proxmox": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://proxmox-mcp-server.vercel.app/api/mcp"],
"env": {
"HEADER_Authorization": "Bearer YOUR_MCP_API_KEY"
}
}
}
}Cloudflare Tunnel経由。Proxmoxサーバーへの直接アクセスは不可。外部からのポートスキャンも無効。
MCPレイヤーでAPIキー認証 + ProxmoxレイヤーでPVE APIトークン。どちらか一方が漏洩しても不正操作不可。
サーバーにDBなし。トークンはVercel環境変数で管理。リクエスト処理中にのみ使用。ログ出力なし。
Claude → Vercel → Cloudflare → Proxmox。全経路がHTTPS。平文通信は一切なし。
堀が公開している MCP サーバー群。すべて Claude.ai / Cursor 等から利用可能。
| サーバー | ツール | 説明 |
|---|---|---|
| b2cloud-api | 14 | ヤマト B2クラウド送り状発行 API/MCP |
| cloudflare-mcp | 69 | Cloudflare 統合(Tunnel/DNS/Workers/Pages/R2/KV/SSL/Access) |
| hubspot-ma-mcp | 128 | HubSpot MA(CRM/Marketing/Knowledge Store) |
| msgraph-mcp-server | 48 | Microsoft Graph API(Exchange/Teams/OneDrive/SharePoint) |
| playwright-devtools-mcp | 57 | Playwright + Chrome DevTools(ブラウザ自動化) |
| proxmox-mcp-server ← 今ここ | 35 | Proxmox VE 仮想化基盤操作 |
| printer-mcp-server | — | CUPS ネットワークプリンタ制御(Kyocera TASKalfa) |
| yamato-printer-mcp-server | — | ヤマト送り状サーマルプリンタ(ラズパイ + WS-420B) |
| ssh-mcp-server | 10 | SSH クライアント(セッション管理/非同期コマンド) |
| mac-remote-mcp | 34 | macOS リモート制御(Shell/GUI/ファイル/アプリ) |
| gemini-image-mcp | 4 | Gemini/Imagen 画像生成 |
| runpod-mcp | 36 | RunPod GPU FaaS(Pods/Endpoints/Jobs) |
| firecrawl-mcp | — | Firecrawl セルフホスト Web スクレイピング |
| ad-ops-mcp | 62 | 広告運用自動化(Google Ads/Meta/GBP/X) |