Mobile Xray MCP

Mobile Xray MCP is an MCP server that connects AI coding assistants directly to local mobile development environments, enabling automated screenshot capture and visual analysis. It connects to active iOS Simulators via xcrun simctl and Android Virtual Devices via the Android Debug Bridge (ADB). Mobile software developers, UI designers, and quality assurance engineers use this server inside AI-powered IDEs such as Claude Desktop, Cursor, Windsurf, and VS Code. Instead of manually exporting simulator screens and attaching files to chats, developers can ask their IDE assistant to inspect running views automatically. The server provides the current simulator screen directly to the connected large language model, facilitating tasks such as evaluating interface accessibility, auditing color contrast, reviewing design layouts against mobile-first standards, and verifying UI changes immediately after editing application code. The tool runs locally on the host machine to maintain data privacy while streamlining the iterative mobile app development cycle across cross-platform frameworks like React Native, Flutter, and native mobile apps.

Category: Browser & Web Automation

Tags: automation, ide, mobile, screenshots, ui-testing

Visit Mobile Xray MCP

How to install and configure Mobile Xray MCP

1. Ensure system prerequisites are installed: Node.js 18 or higher, plus Xcode Command Line Tools (xcode-select --install) for iOS development on macOS, or Android Studio with SDK tools added to your PATH for Android. 2. Open your IDE or client MCP configuration file (such as in Cursor, Windsurf, Claude Desktop, or VS Code). 3. Add the server entry under the mcpServers object: json { "mcpServers": { "mobile-xray": { "command": "npx", "args": ["-y", "@cultivx/mobile-xray-mcp"] } } } 4. Restart your IDE or MCP client. 5. Start your iOS Simulator (open -a Simulator) or Android Emulator, then test the tool by prompting your AI assistant: "Take a screenshot of my iOS simulator".

What you can do with Mobile Xray MCP

• Capturing screenshots of active iOS simulators or Android emulators directly from the AI assistant chat interface. - Auditing mobile screen layouts and typography against mobile-first UX guidelines and general design principles without leaving the code editor. - Evaluating screen elements for accessibility standards, such as color contrast levels and missing accessibility tags. - Verifying visual changes instantly after applying code modifications by commanding the AI agent to capture a fresh simulator frame. - Detecting supported local platforms and available virtual devices automatically across macOS, Windows, and Linux workstations.

Key facts

• https://github.com/CultivX/mobile-xray-mcp
• Browser & Web Automation, Design, Media & Creative, Developer Tools & Code Intelligence
• automation, ide, mobile, screenshots, ui-testing

Part of MCP Servers

What can Mobile Xray MCP do?

Mobile Xray MCP enables AI coding assistants to automatically detect active mobile development environments, capture screenshots from running iOS simulators or Android emulators, and deliver those visuals directly into your IDE chat. This allows language models to analyze UI design, review layout accessibility, verify recent code changes, and propose concrete UX improvements without manual image file exports.

How do I install Mobile Xray MCP?

You can install it by configuring your IDE or MCP client configuration file with the command npx and arguments -y and @cultivx/mobile-xray-mcp under the mcpServers configuration object. Ensure Node.js 18 or higher is installed along with Xcode tools on macOS for iOS, or Android SDK tools configured in your system PATH for Android emulators.

Which MCP clients work with Mobile Xray MCP?

Mobile Xray MCP works with any AI assistant or development environment supporting the Model Context Protocol. Supported clients include Claude Desktop, Cursor, Windsurf, and VS Code. As long as your client communicates over standard MCP protocols and has access to local CLI utilities, it can execute the server.

Does Mobile Xray MCP support physical mobile devices?

No, physical iOS and Android hardware are not currently supported. The server only captures screens and interacts with local iOS Simulators and Android Virtual Devices running on your host machine.

Is Mobile Xray MCP open source?

Yes, Mobile Xray MCP is open-source software released under the Apache License 2.0. The code repository, licensing details, and contribution instructions can be viewed publicly on GitHub.