proxmox-mcp

proxmox-mcp は、Proxmox VE API 向けの、セーフティゲート付きローカル stdio Model Context Protocol サーバーです。MCP ホストによってプロセスとして起動されます。HTTP サービスではなく、HTTP エンドポイントを公開しません。

ステータス — 現在のリリース: v0.1.1。 公式の配布物は GitHub Release アーカイブとその SHA-256 チェックサムです。npm パッケージは提供も公開もされていません。

リリース版 Proxmox MCP のインストール

ローカル stdio インストールでは、チェックサムで検証済みの GitHub Release アーカイブを使用します:

• GitHub Release v0.1.1

• アーカイブアセット

• チェックサムアセット

npm パッケージはありません。LobeHub Marketplace のリストは機能を説明するものであり、ローカルインストールのソースではありません。ClawHub は、公開インストール可能な OpenClaw ラッパー/リストが利用できないため、現在公開されていません。

Related MCP server: mcp-server-proxmox

クイックインストール

GitHub Releases から v0.1.1 アーカイブとチェックサムをダウンロードし、検証して、アーカイブを展開します。これは MCP ホストが実行されるマシン上で行ってください。

curl -fLO https://github.com/Theorvane/proxmox-mcp/releases/download/v0.1.1/proxmox-mcp-0.1.1.tar.gz
curl -fLO https://github.com/Theorvane/proxmox-mcp/releases/download/v0.1.1/proxmox-mcp-0.1.1.tar.gz.sha256
shasum -a 256 -c proxmox-mcp-0.1.1.tar.gz.sha256
tar -xzf proxmox-mcp-0.1.1.tar.gz
cd proxmox-mcp-0.1.1

このアーカイブには Node.js >=22 が必要です。認証情報は環境変数で提供してください。以下の値はプレースホルダーであり、実際に機能する認証情報ではありません。

export PROXMOX_BASE_URL='https://proxmox.example:8006'
export PROXMOX_TOKEN_ID='user@realm!token-name'
: "${PROXMOX_TOKEN_SECRET:?set PROXMOX_TOKEN_SECRET in the environment}"
./proxmox-mcp

./proxmox-mcp は stdio プロセスです。そのコマンド、作業ディレクトリ、および 3 つの環境変数を MCP ホストに登録または設定してください。ターミナルで単独で起動しても、クライアントが利用できるようにはなりません。アーカイブの構成とインストールの詳細については、GitHub Release インストールガイド を参照してください。

設定

使用される環境変数は以下のものだけです:

TLS 証明書の検証は常に有効です。PROXMOX_TLS_VERIFY=false は起動時に拒否されます。使用しないでください。Proxmox エンドポイントがプライベート CA を使用している場合は、その CA をホストのトラストストアで信頼してください。完全なポリシーについては 設定 を参照してください。

機能

このサーバーは、厳選された Proxmox VE 操作を提供します。MCP ホストは、接続時に正確なスキーマとツールの説明を検出します。

ツール名、入力、出力、およびノード名の検証ルールは ツールコントラクト に文書化されています。

セーフティモデル

削除、未使用ディスクの削除、強制停止は、元に戻せない可能性があります。ターゲットを慎重に確認し、トークンには必要な Proxmox 権限のみを付与してください。完全な セーフティガイダンス を参照してください。

OpenClaw ローカルスキル

マージされた dev コードベースには、skills/proxmox-mcp-openclaw/ に OpenClaw スキルが含まれています。これはローカルスキルであり、汎用の OpenClaw プラグインではありません。そのローカルの SKILL.md の手順を使用してください。

新しい絶対ターゲットディレクトリを選択してください — ターゲットは既に存在してはいけません。まず、認証情報を含まないプランを確認してください:

node skills/proxmox-mcp-openclaw/scripts/install.mjs --dry-run /absolute/path/to/proxmox-mcp

シェルで 3 つの設定変数をエクスポートした状態で、インストールして登録します:

node skills/proxmox-mcp-openclaw/scripts/install.mjs /absolute/path/to/proxmox-mcp

インストーラーは、不変の v0.1.1 リリースとそのチェックサムを検証し、プリフライトが成功した後にのみ、サポートされている openclaw mcp add コマンドを呼び出します。認証情報をログに記録したり保存したりしません。

運用上の境界

• これはローカルの stdio MCP 統合であり、ホスト型サービスや Proxmox アクセス制御の代替ではありません。

• サーバーは、MCP クライアントがツールを呼び出すまで Proxmox リクエストを行いません。インストールおよびドキュメントの例は、実際の Proxmox API を呼び出しません。

• 認証情報をリポジトリ、可能な場合はシェル履歴、共有設定ファイルに保存しないでください。最小権限の Proxmox API トークンを使用してください。

• リリースは Theorvane/proxmox-mcp GitHub Releases からのみ取得し、アーカイブを実行する前に公開されている SHA-256 チェックサムを検証してください。

ドキュメント

• 設定

• セーフティ

• API およびツールコントラクト

• GitHub Release インストール

• コントリビューティング

• セキュリティ

検証とコントリビューティング

コントリビューターは dev をベースにした issue 番号付きブランチで作業し、dev にプルリクエストを開き、レビュー済みの dev のみを main に昇格させます。GitHub Release アーカイブが唯一の配布チャネルです。CONTRIBUTING.md を参照してください。

メンテナーは、プロジェクトで使用される同じローカル検証コマンドを実行できます:

npm ci
npm run lint
npm run typecheck
npm test
npm run build
npm run release:archive
npm run verify:release-archive
npm run validate:docs
npm run validate:governance
npm run validate:release
npm audit --omit=dev --audit-level=high
git diff --check

ライセンス

このプロジェクトは LICENSE の条項に基づいてライセンス供与されます。