Vmware Fusion MCP Server

🚀 VMware Fusion MCP Server

VMware Fusion MCP Server 是一個基於 FastMCP 構建的模型上下文協議（MCP）服務器，它藉助 Fusion REST API 來管理 VMware Fusion 虛擬機，為用戶提供便捷的虛擬機管理方案。

🚀 快速開始

在使用 VMware Fusion MCP Server 之前，你需要完成以下準備工作：

• 安裝 VMware Fusion Pro 並啟用 REST API。
• 安裝 Python 3.10+。
• 推薦安裝 uv 或使用 pip。
• 若要集成 VS Code/LLM，需安裝 uvx。

✨ 主要特性

• 虛擬機列表查看：可查看 VMware Fusion 中註冊的所有虛擬機。
• 虛擬機信息獲取：能夠獲取特定虛擬機的詳細信息。
• 電源操作：支持對虛擬機執行開機、關機、掛起、暫停、恢復、重置等電源操作。
• 電源狀態查詢：可查詢虛擬機的當前電源狀態。
• 現代 MCP/LLM 集成：將所有功能作為 MCP 工具暴露給大語言模型（LLMs）和代理框架。

📦 安裝指南

克隆倉庫

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

環境搭建與依賴安裝

make env

📚 詳細文檔

VMware Fusion 設置

啟用 REST API

• 打開 VMware Fusion，選擇“偏好設置”>“高級”。
• 勾選“啟用 REST API”。
• 記錄 API 端口（默認：8697）。

啟動 REST API 服務

vmrest

默認情況下，API 將在 http://localhost:8697 可用。

配置

服務器默認連接到 http://localhost:8697 的 VMware Fusion REST API。你需要使用環境變量為 vmrest API 配置身份驗證：

• VMREST_USER：vmrest API 的用戶名（啟用身份驗證時必需）。
• VMREST_PASS：vmrest API 的密碼（啟用身份驗證時必需）。

你可以在 shell、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 兼容客戶端）中使用此服務器作為工具提供程序，請按以下步驟操作：

安裝 uvx

uv pip install uvx

添加到 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 憑據。設置完成後，你就可以在任何支持 MCP 的 LLM 或 VS Code 代理中使用 VMware Fusion 工具了。

MCP 工具

list_vms

• 描述：列出 VMware Fusion 中的所有虛擬機。
• 參數：無

get_vm_info

• 描述：獲取特定虛擬機的詳細信息。
• 參數：
  • vm_id（字符串）：虛擬機的 ID

power_vm

• 描述：對虛擬機執行電源操作。
• 參數：
  • vm_id（字符串）：虛擬機的 ID
  • action（字符串）：可選值為 "on"、"off"、"suspend"、"pause"、"unpause"、"reset"

get_vm_power_state

• 描述：獲取特定虛擬機的電源狀態。
• 參數：
  • vm_id（字符串）：虛擬機的 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. Fork 倉庫。
2. 創建功能分支。
3. 進行更改。
4. 運行測試和代碼檢查：make test && make lint。
5. 提交拉取請求。

🔗 參考資料

• FastMCP 文檔
• 模型上下文協議
• uvx
• fetch 服務器示例