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 服务器示例