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 your .gemini/antigravity/mcp_config.json:

"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