Skip to content
MCP server

MCP Virtual Computer

A persistent Docker or Fly computer with a Three.js interface and optional live Xfce…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.2.11
Listing updated
4 days ago

About MCP Virtual Computer

MCP Virtual Computer is an open-source MCP server. It runs locally on your machine and is started by your AI client.

A persistent Docker or Fly computer with a Three.js interface and optional live Xfce desktop.

Install

Run in a terminal

claude mcp add mcp-virtual-computer --env COMPUTER_ID='<COMPUTER_ID>' --env FLY_API_TOKEN='<FLY_API_TOKEN>' -- uvx mcp-virtual-computer

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-virtual-computer": {
      "command": "uvx",
      "args": [
        "mcp-virtual-computer"
      ],
      "env": {
        "COMPUTER_ID": "<COMPUTER_ID>",
        "FLY_API_TOKEN": "<FLY_API_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-virtual-computer": {
      "command": "uvx",
      "args": [
        "mcp-virtual-computer"
      ],
      "env": {
        "COMPUTER_ID": "<COMPUTER_ID>",
        "FLY_API_TOKEN": "<FLY_API_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-virtual-computer": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-virtual-computer"
      ],
      "env": {
        "COMPUTER_ID": "<COMPUTER_ID>",
        "FLY_API_TOKEN": "<FLY_API_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-virtual-computer": {
      "command": "uvx",
      "args": [
        "mcp-virtual-computer"
      ],
      "env": {
        "COMPUTER_ID": "<COMPUTER_ID>",
        "FLY_API_TOKEN": "<FLY_API_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-virtual-computer": {
      "command": "uvx",
      "args": [
        "mcp-virtual-computer"
      ],
      "env": {
        "COMPUTER_ID": "<COMPUTER_ID>",
        "FLY_API_TOKEN": "<FLY_API_TOKEN>"
      }
    }
  }
}

Configuration

  • BACKENDComputer provider. Use docker for a local container or fly for a permanent Fly Machine.
  • COMPUTER_IDStable identity of the one persistent computer.Required
  • DESKTOP_ENVIRONMENTStart the real Xfce desktop instead of the virtual desktop.
  • NETWORK_ACCESSAllow outbound network access from the computer.
  • AUTO_INSTALL_DOCKEROn Windows, install and start Docker Desktop lazily when needed.
  • AUTO_INSTALL_FLYCTLDownload flyctl into the user profile when it is missing.
  • FLY_API_TOKENOptional Fly API token. A cached flyctl login is also supported.
  • EXPOSE_LIFECYCLE_TOOLSAlso expose runtime status and network/desktop switching tools to the model. The MCP App can always use them.

Pricing

Open source

MCP Virtual Computer FAQ

Is MCP Virtual Computer free?

Yes. MCP Virtual Computer is open source, so you can use and self-host it for free.

How do I add MCP Virtual Computer to Claude Code?

Run this command in your terminal: claude mcp add mcp-virtual-computer --env COMPUTER_ID='<COMPUTER_ID>' --env FLY_API_TOKEN='<FLY_API_TOKEN>' -- uvx mcp-virtual-computer