VMware Fusion MCP Server

VMware Fusion MCP 服务

---

这是一个 Model Context Protocol（MCP）服务，使用 FastMCP 构建，可通过 Fusion REST API 管理 VMware Fusion 虚拟机。

---

功能

• 列出虚拟机：查看 VMware Fusion 中注册的所有虚拟机。
• 获取虚拟机信息：检索特定虚拟机的详细信息。
• 电源操作：对虚拟机执行电源操作（启动、关闭、挂起、暂停、恢复、重置）。
• 获取电源状态：查询虚拟机当前的电源状态。
• 现代 MCP/大模型集成：将所有功能作为 MCP 工具提供给大模型和 Agent 框架。

---

前提条件

• VMware Fusion Pro（已启用 REST API）
• Python 3.10+
• uv（推荐）或 pip
• uvx（用于 VS Code/大模型集成）

---

安装

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 访问。

---

配置

服务默认连接到 VMware Fusion 的 REST API http://localhost:8697。你必须使用环境变量为 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/大模型）

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

---

VS Code / 大模型集成

要在 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 的大模型或 Agent 中使用 VMware Fusion 工具。

---

MCP 工具

list_vms

• **描述：**列出 VMware Fusion 中的所有虚拟机。
• **参数：**无

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. Fork 此仓库
2. 创建功能分支
3. 进行更改
4. 运行测试和代码检查：make test && make lint
5. 提交拉取请求

---

参考资料

• FastMCP 文档
• Model Context Protocol
• uvx
• fetch 服务示例