Proxmox MCP Server

PythonベースのProxmox管理サーバーで、Proxmox仮想化プラットフォームとのインタラクション用のインターフェイスを提供し、ノード、仮想マシン、コンテナの管理をサポートし、セキュリティ認証と豊富な機能ツールを備えています。

仮想化開発者ツール #仮想化管理 #Pythonツール #サーバー運用 #APIインターフェイス .Python

スコア : 3ポイント

ダウンロード数 : 122

更新時間 : 2025-04-23

Proxmox MCPサーバーとは？

Proxmox MCPサーバーは、Model Context Protocol (MCP)に基づくサーバーで、Proxmox仮想化プラットフォームとのインタラクションに特化して設計されています。ユーザーフレンドリーなインターフェイスを提供し、Proxmoxの複雑なAPIを深く理解することなく、仮想化環境を簡単に管理できます。

Proxmox MCPサーバーの使い方は？

簡単なコマンドまたはグラフィカルインターフェイスを通じてサーバーとインタラクションし、ノードの状態を照会したり、仮想マシンを管理したり、コマンドを実行したりできます。サーバーは設定ファイルによる設定をサポートし、詳細なログ記録を提供します。

適用シーン

複数のProxmoxノードを集中管理する必要があるシーンに適しています。特に、個々のノードに個別にログインするのではなく、統一されたインターフェイスで操作したい場合に便利です。また、Proxmox管理を自動化ワークフローに統合する必要があるユーザーにも適しています。

主要機能

ノード管理すべてのProxmoxノードの状態とリソース使用状況を表示および管理する

仮想マシン管理仮想マシンをリスト表示、照会、制御し、コンソールコマンドの実行も可能

ストレージ管理ストレージプールの状態と使用状況を表示する

クラスター状態Proxmoxクラスター全体の総合的な状態情報を取得する

セキュリティ認証APIトークンを使用したセキュアな認証を行い、SSL検証をサポートする

ログ記録設定可能なログシステムで、異なる詳細レベルをサポートする

利点と制限

利点

オリジナルのProxmox APIよりもシンプルなインターフェイスを提供する

MCPプロトコルを通じて他のツールとの統合をサポートする

詳細なリソース使用状況の可視化

セキュアなトークン認証メカニズム

豊富な出力形式オプション

制限

APIトークンの事前設定が必要

Proxmoxの高度な機能のサポートが限られている

Python環境での実行が必要

一部の機能にはQEMU Guest Agentのサポートが必要

使い方

インストール準備

Python 3.10以上がインストールされていることを確認し、GitとUVパッケージマネージャーをインストールします。

リポジトリをクローンする

Proxmox MCPサーバーのソースコードを取得します。

仮想環境を設定する

Python仮想環境を作成してアクティブ化します。

依存関係をインストールする

すべての必要なPython依存パッケージをインストールします。

サーバーを設定する

サンプル設定ファイルをコピーし、環境に合わせて変更します。

サーバーを起動する

MCPサーバーを起動します。

使用例

クラスターの健全性を監視する定期的にクラスター内のすべてのノードの状態とリソース使用状況を確認する

仮想マシンのメンテナンス複数の仮想マシンで同じメンテナンスコマンドを実行する

リソース計画すべてのノードのリソース使用状況を確認して容量計画を行う

よくある質問

Proxmox APIトークンを取得するにはどうすればいいですか？

仮想マシンのコマンドの実行が失敗するのはなぜですか？

ログの詳細度を上げるにはどうすればいいですか？

サーバーはどのProxmoxバージョンをサポートしていますか？

Clineデスクトップ環境に統合するにはどうすればいいですか？

🚀 Proxmox MCP プロジェクトドキュメント

Proxmox MCPは、Proxmox環境における仮想マシン管理やストレージ管理などの機能を提供するツールです。このドキュメントでは、Proxmox MCPのインストール方法、使用方法、機能概要などについて説明します。

🚀 クイックスタート

Proxmox MCPを使用するには、まずインストールする必要があります。インストール方法については、以下の「📦 インストール」を参照してください。インストールが完了したら、「💻 使用例」で示す手順に従って設定と起動を行います。

📦 インストール

インストール方法

PyPI を通じたインストール： pip を使用してインストールします。
```
pip install proxmox-mcp
```
ソースコードからのインストール：リポジトリをクローンしてインストールします。
```
git clone https://github.com/yourusername/proxmox-mcp.git
cd proxmox-mcp
python setup.py install
```

💻 使用例

基本的な使用法

設定ファイル

config.example.json を config.json にコピーし、必要に応じて設定を変更します。

MCP サービスの起動

仮想環境で MCP を起動します。

python -m proxmox_mcp.server

✨ 主な機能

MCP は以下の主要な機能を提供します：

VM 管理：仮想マシンの作成、削除、管理を行います。
ストレージ管理：ストレージプールの設定と監視を行います。
ネットワーク管理：ネットワークインターフェイスとファイアウォールルールの管理を行います。
クラスター状態：Proxmox クラスター全体の状態情報を確認できます。

📚 ドキュメント

ツールガイド

ヘルプの取得

mcp --help を使用して、利用可能なすべてのコマンドとそのオプションを表示します。

開発情報

テストの実行

仮想環境でテストを実行します。

pytest tests/

コードのフォーマット

プロジェクトのコードをフォーマットします。

black .

型チェック

静的型チェックを行います。

mypy .

コード規約

コードスタイルをチェックします。

ruff .

プロジェクト構造

proxmox-mcp/
├── src/
│   └── proxmox_mcp/
│       ├── server.py          # 主な MCP サービスの実装
│       ├── config/            # 設定処理モジュール
│       ├── core/              # 核心機能モジュール
│       ├── formatting/        # 出力のフォーマットとテーマモジュール
│       ├── tools/             # ツールの実装モジュール
│       │   └── console/       # VM コンソール操作のサブモジュール
│       └── utils/             # 補助ツールモジュール（認証、ログ）
├── tests/                     # テストスイートのディレクトリ
├── proxmox-config/
│   └── config.example.json    # 設定ファイルのサンプル
├── pyproject.toml            # プロジェクトのメタデータと依存関係管理
└── LICENSE                   # MIT ライセンスファイル