@deskcloud/mcp

@deskcloud/mcp

Official MCP client for DeskCloud - AI-controlled virtual desktops.

What is DeskCloud?

DeskCloud provides AI agents with isolated virtual desktop environments. Your AI can:

• 🖥️ Control a full Ubuntu desktop
• 🌐 Browse the web with a real browser
• 📁 Manage files and run applications
• 📹 Record session videos for review

Quick Start

1. Get your API Key

Sign up at deskcloud.app and get your API key from the dashboard.

2. Configure your MCP Client

Cursor IDE (.cursor/mcp.json):

{
  "mcpServers": {
    "deskcloud": {
      "command": "npx",
      "args": ["@deskcloud/mcp"],
      "env": {
        "DESKCLOUD_API_KEY": "dk_your_api_key_here"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "deskcloud": {
      "command": "npx",
      "args": ["@deskcloud/mcp"],
      "env": {
        "DESKCLOUD_API_KEY": "dk_your_api_key_here"
      }
    }
  }
}

3. Start using it!

Ask Claude or your AI assistant to:

"Create a desktop session and open Firefox to search for the weather"

Available Tools

Tool	Description
create_session	Create a new virtual desktop session
execute_task	Run a task in the desktop (AI controls mouse/keyboard)
get_session_status	Get session info including VNC URL
take_screenshot	Capture current desktop state
destroy_session	End a session
session_file_add	Upload a file to the session
session_file_list	List files in the session
session_file_read	Read file contents
session_file_export	Download a file from the session

Environment Variables

Variable	Required	Description
DESKCLOUD_API_KEY	Yes	Your DeskCloud API key (starts with dk_)
DESKCLOUD_SERVER_URL	No	Custom server URL (for self-hosted)

Self-Hosted

If you're running your own DeskCloud server, set the server URL:

{
  "mcpServers": {
    "deskcloud": {
      "command": "npx",
      "args": ["@deskcloud/mcp"],
      "env": {
        "DESKCLOUD_API_KEY": "dk_your_key",
        "DESKCLOUD_SERVER_URL": "https://your-server.com/mcp/sse"
      }
    }
  }
}

Links

• 🌐 Website
• 📖 Documentation
• 🐙 GitHub
• 🆘 Issues

License

MIT