Vmware Fusion MCP Server

🚀 VMware Fusion MCP Server

VMware Fusion MCP Serverは、Fusion REST APIを介してVMware Fusionの仮想マシンを管理するためのModel Context Protocol (MCP)サーバーです。FastMCPを用いて構築されています。

🚀 クイックスタート

このサーバーを使用することで、VMware Fusionの仮想マシンを簡単に管理できます。以下の手順に従ってセットアップしましょう。

✨ 主な機能

• VMの一覧表示：VMware Fusionに登録されているすべてのVMを表示します。
• VM情報の取得：特定のVMの詳細情報を取得します。
• 電源操作：VMに対して電源のオン、オフ、一時停止、一時停止解除、リセットなどの操作を行います。
• 電源状態の取得：特定のVMの現在の電源状態を照会します。
• 最新のMCP/LLM統合：すべての機能をMCPツールとしてLLMやエージェントフレームワークに公開します。

📦 インストール

前提条件

• VMware Fusion Pro (REST APIを有効にする必要があります)
• Python 3.10以上
• uv (推奨) またはpip
• uvx (VS Code/LLM統合用)

インストール手順

1. リポジトリをクローンします：

git clone https://github.com/yeahdongcn/vmware-fusion-mcp-server.git
cd vmware-fusion-mcp-server

2. 環境をセットアップし、依存関係をインストールします：

make env

📚 ドキュメント

VMware Fusionのセットアップ

1. REST APIを有効にします：

   • VMware Fusionを開き、「環境設定」>「詳細」を選択します。
   • 「REST APIを有効にする」をチェックします。
   • APIポートを確認します (デフォルト: 8697)。

2. REST APIサービスを起動します：

vmrest

APIはデフォルトでhttp://localhost:8697で利用可能になります。

設定

サーバーはデフォルトでhttp://localhost:8697のVMware FusionのREST APIに接続します。vmrest APIの認証を環境変数を使用して設定する必要があります：

• VMREST_USER：vmrest APIのユーザー名 (認証が有効な場合必須)
• VMREST_PASS：vmrest APIのパスワード (認証が有効な場合必須)

これらはシェル、VS CodeのMCP設定、またはデプロイ環境で設定する必要があります。

例: 資格情報付きのVS Code用MCPサーバー設定

{
  "mcpServers": {
    "vmware-fusion": {
      "command": "uvx",
      "args": ["vmware-fusion-mcp-server"],
      "env": {
        "VMREST_USER": "your-username",
        "VMREST_PASS": "your-password"
      }
    }
  }
}

• VMREST_USERとVMREST_PASSをvmrestの資格情報に設定します。

使用方法

MCPサーバーの実行

Makeを使用する場合

VMREST_USER=your-username VMREST_PASS=your-password make run

uvxを使用する場合 (VS Code/LLM用に推奨)

VMREST_USER=your-username VMREST_PASS=your-password uvx vmware-fusion-mcp-server

VS Code / LLM統合

このサーバーをVS Code (またはMCP互換クライアント) のツールプロバイダーとして使用するには：

1. uvxをインストールします：

uv pip install uvx

2. MCPサーバー設定に追加します (例: .vscode/mcp.json)：

{
  "mcpServers": {
    "vmware-fusion": {
      "command": "uvx",
      "args": ["vmware-fusion-mcp-server"],
      "env": {
        "VMREST_USER": "your-username",
        "VMREST_PASS": "your-password"
      }
    }
  }
}

• VMREST_USERとVMREST_PASSをvmrestの資格情報に設定します。
• これで、VS CodeのMCP対応LLMやエージェントでVMware Fusionツールを使用できます。

MCPツール

list_vms

• 説明：VMware Fusion内のすべてのVMをリストします。
• パラメータ：なし

get_vm_info

• 説明：特定のVMに関する詳細情報を取得します。
• パラメータ：
  • vm_id (文字列)：VMのID

power_vm

• 説明：VMに対して電源操作を実行します。
• パラメータ：
  • vm_id (文字列)：VMのID
  • action (文字列)："on", "off", "suspend", "pause", "unpause", "reset" のいずれか

get_vm_power_state

• 説明：特定のVMの電源状態を取得します。
• パラメータ：
  • vm_id (文字列)：VMのID

開発

テストの実行

make test

コードのフォーマット

make fmt

リント

make lint

プロジェクト構造

• vmware_fusion_mcp/server.py - 主なFastMCPサーバーの実装
• vmware_fusion_mcp/vmware_client.py - VMware Fusion REST APIクライアント
• tests/ - 単体テストと統合テスト

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEを参照してください。

🤝 貢献の方法

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更を加えます。
4. テストとリントを実行します：make test && make lint
5. プルリクエストを送信します。

🔗 参考文献

• FastMCP Documentation
• Model Context Protocol
• uvx
• fetch server example