VMware Fusion MCP Server

VMware Fusion MCP Server

---

FastMCP を使用して構築された、Fusion REST API 経由で VMware Fusion 仮想マシンを管理するための Model Context Protocol（MCP）サーバーです。

---

機能

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

---

前提条件

• 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 > Preferences > Advanced を開きます
   • 「Enable 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 (string)：VM の ID

power_vm

• 説明： VM の電源操作を実行します。
• パラメーター：
  • vm_id (string)：VM の ID
  • action (string)：次のいずれか：「on」、「off」、「suspend」、「pause」、「unpause」、「reset」

get_vm_power_state

• 説明： 特定の VM の電源状態を取得します。
• パラメーター：
  • vm_id (string)：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 ドキュメント
• Model Context Protocol
• uvx
• fetch サーバーの例