Emuluxe MCP Server 🚀

Emuluxe MCP is the ultimate Model Context Protocol (MCP) server for mobile web simulation. It allows AI agents (like those in Cursor, VS Code, and Antigravity) to instantly launch mobile environments to test and verify web applications.

🌟 Features

• Zero-Install: Run instantly with npx.
• Multi-IDE Ready: Native support for Antigravity, Cursor, and VS Code.
• Instant Launch: Deep-link integration triggers simulation panels automatically.
• Production-Grade: Built on the official Emuluxe Simulation API.

🚀 Quick Start (Zero-Install)

No cloning or installation required. Just add it to your IDE's MCP configuration.

🍱 1. Get your Token

1. Sign up/Login at app.emuluxe.com.
2. Go to Settings → API Tokens.
3. Copy your EMULUXE_TOKEN.

🎨 2. Add to your IDE

Cursor (Native Support)

1. Open Cursor Settings (Cmd + Shift + J).
2. Go to Features → MCP Servers.
3. Click + Add New MCP Server.
4. Name: Emuluxe
5. Type: command
6. Command:

   npx -y @emuluxe/mcp-server

7. Environment Variables:
   • EMULUXE_TOKEN: your_token_here
   • EMULUXE_IDE: cursor

VS Code (via Roo Code / Cline)

Add this to your mcp_config.json:

"emuluxe": {
  "command": "npx",
  "args": ["-y", "@emuluxe/mcp-server"],
  "env": {
    "EMULUXE_TOKEN": "your_token_here"
  }
}

Antigravity

Add this to .gemini/antigravity/mcp_config.json:

"emuluxe": {
  "command": "npx",
  "args": ["-y", "@emuluxe/mcp-server"],
  "env": {
    "EMULUXE_TOKEN": "your_token_here"
  }
}

Windsurf

1. Open Windsurf Settings.
2. Go to Cascade → MCP Servers.
3. Click + Add New MCP Server.
4. Name: Emuluxe
5. Type: command
6. Command:

   npx -y @emuluxe/mcp-server

7. Environment Variables:
   • EMULUXE_TOKEN: your_token_here
   • EMULUXE_IDE: windsurf

Claude Desktop & Claude Code CLI Support

The Emuluxe MCP server intelligently handles different environments:

In IDE (VS Code, Cursor, Windsurf, Antigravity)

• Simulation panel opens inside the editor
• No special configuration needed

In Terminal (Claude Desktop, Claude Code CLI)

• Free tier: Returns CLI command to run
• Pro/Enterprise: Opens platform dashboard in browser

Setup for Claude Code CLI

claude mcp add --transport stdio --env EMULUXE_TOKEN=your_token emuluxe -- npx -y @emuluxe/mcp-server

Setup for Claude Desktop

Add to Claude Desktop MCP configuration:

"emuluxe": {
  "command": "npx",
  "args": ["-y", "@emuluxe/mcp-server"],
  "env": {
    "EMULUXE_TOKEN": "your_token_here"
  }
}

🛠 Available Tools

simulate

Launches a mobile simulation of a URL on a specific device.

Arguments:

• url (string, required): The URL to simulate (e.g., https://google.com).
• device (string, optional): The device ID (e.g., iphone-15-pro-max, pixel-8-pro). Defaults to iphone-15-pro-max.

🔍 Troubleshooting

Extension Doesn't Open

• Ensure you have the Emuluxe VS Code Extension installed.
• Check the terminal output of the MCP server. It always provides a Manual Bridge Link if the deep-link fails.

Authentication Errors

• Verify your EMULUXE_TOKEN is correct and hasn't expired.
• You can also set the token globally using the Emuluxe CLI.

📄 License

ISC © Emuluxe