@deskcloud/mcp
v0.1.0
Published
DeskCloud MCP client - AI-controlled virtual desktops
Maintainers
Readme
@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
