Mobile Xray MCP

by cultivx

Not rated
GitHub

About

Take screenshots and analyze mobile apps with AI assistance directly from your IDE.

Details

Author
cultivx
Categories
Developer Tools, Other, AI
Tags
#mobile

Setup

Install Mobile Xray MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/cultivx/mobile-xray-mcp

Follow the installation instructions in the repository README, then restart your MCP client.

πŸ”¬Take screenshots and analyze your mobile apps with AI assistance - right from your IDE.

Privacy Firstβ€’Built by Developers for Developersβ€’Works Locally

I've been building mobile apps for the last 10 years, and one thing that's been consistently challenging without a dedicated UX designer is knowing whether the screens I create are actually user-friendly and intuitive.

Now, this has become dramatically easier. With Mobile Xray MCP, you can ask your favorite AI-powered IDE (Claude, Cursor, Windsurf, VS Code) to take a screenshot of your app and give you instant suggestions on what to improve. No more guessing about UI/UX decisions - get feedback directly in your development workflow.

This tool bridges the gap between development and design by bringing mobile app analysis capabilities directly into your coding environment, making it easier than ever to create polished, user-friendly mobile applications.

- πŸ”’Privacy First: All automation happens locally on your machine - your app screenshots and data never leave your device
- ⚑Fast: Direct communication with local simulators and emulators for instant feedback
- πŸ“±Cross-Platform: Supports both iOS simulators and Android emulators
- πŸ€–AI-Powered: Integrates seamlessly with AI coding assistants for intelligent analysis
- πŸ‘¨β€πŸ’»Developer-Focused: Built by developers who understand the mobile development workflow

Prerequisites:Node.js 18+, iOS Simulator or Android Emulator

{ "mcpServers": { "mobile-xray": { "command": "npx", "args": ["-y", "@cultivx/mobile-xray-mcp"] } } }

Test:Restart IDE β†’ Start simulator β†’ Ask:"Take a screenshot of my iOS simulator"

- Node.js 18+(check withnode --version)
- macOS 10.15+(for iOS development)
- macOS/Windows/Linux(for Android development)

- Xcode Command Line Tools:xcode-select --install
- Xcode with iOS Simulator support
- At least one iOS Simulator installed

- Android Studio (includesadbandemulatorcommands)
- Android SDK tools in your PATH
- At least one Android Virtual Device (AVD) created

# Test Node.js version node --version # Should show v18.0.0 or higher # Test iOS tools (macOS only) xcrun simctl list devices | head -5 # Test Android tools adb version

For Cursor: SeeCursor MCP Documentation

For Claude Desktop: SeeClaude MCP Quickstart

For Windsurf: SeeWindsurf MCP Documentation

For VS Code: SeeVS Code MCP Documentation

Note: This MCP server works with any AI coding assistant that supports the Model Context Protocol.
- Start your mobile simulator/emulator
- Open your AI chat in your IDE
- Ask for a screenshot: "Can you take a screenshot of my iOS simulator?"
- Get AI analysis: "What can I improve about this screen's UX?"

Check which platforms are currently supported by the mobile-xray-mcp on my machine
Take a screenshot of my iOS simulator and tell me what accessibility features I should add
Screenshot my current screen and check if the color contrast meets accessibility standards
Take a screenshot of the current iOS simulator, and find the code that is related to it, then propose some improvements without making any changes
Take a screenshot of my app and suggest improvements for mobile-first design principles
Analyze the current screen layout and suggest improvements for better user flow
Make changes and verify your changes work well by taking a screenshot

- "No simulators found": Start your simulator withopen -a Simulator(iOS) or checkadb devices(Android)
- MCP not connecting: Restart your IDE after adding config, verify JSON syntax is correct
- "Command not found": Install Xcode Command Line Tools (xcode-select --install) or ensure Android SDK is in PATH

- Frameworks: Works with React Native, Flutter, Xamarin, or any app in simulator/emulator
- Physical devices: Not yet supported, simulators/emulators only
- Privacy: The MCP server operates locally and doesn't collect or send any data. Screenshot images are sent to your AI service by your IDE for analysis
- Offline: Screenshots work offline, AI analysis needs internet connection

βœ…Platform Detection: Automatically checks which mobile platforms are available on your system

βœ…Privacy First: All processing performed by the MCP server happens locally - no data sent to external servers. However, screenshot images will be sent to your AI service (Claude, ChatGPT, etc.) for analysis, as handled by your IDE's AI agent

βœ…Screenshot Capture: Take instant screenshots of iOS simulators and Android emulators

βœ…Cross-Platform Support: Works with both iOS and Android development environments

βœ…IDE Integration: Seamlessly works with popular AI-powered IDEs and coding assistants

🚧Interactive Navigation: Enable AI assistants to navigate through your app interface

We welcome contributions! Here's how you can help:
- Forkthis repository
- Createa feature branch (git checkout -b feature/amazing-feature)
- Commityour changes (git commit -m 'Add amazing feature')
- Pushto the branch (git push origin feature/amazing-feature)
- Opena Pull Request

I'll review all PRs and provide feedback. Whether it's bug fixes, new features, or documentation improvements - all contributions are appreciated!

This project is licensed under the Apache License 2.0 - see theLICENSEfile for details.

- πŸ›Issues:GitHub Issues
- πŸ“–Documentation:
Model Context Protocol Docs

Made with ❀️ by developers, for developers

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Bring agent evaluations, observability, and synthetic test set generation directly into your IDE for free with Galileo's new MCP server

Drives an Android emulator or a real device over adb: screenshots, UI hierarchy with true device-pixel coordinates, tap and type, app lifecycle, logcat, and Gradle builds and tests.

Interact with Android devices using the Android Debug Bridge (ADB).

AI 測試倧師 β€” MCP server driving pytest / Jest / Cypress / Go / Maestro. Analyze, generate, run, advise. Web + Mobile (iOS/Android/BlueStacks).

Control Android devices using the Android Debug Bridge (ADB).

Control Android devices via the Android Debug Bridge (ADB).

Automate Android devices using the Gbox SDK.

Catch App Store rejections before they happen

An agentic toolkit to control, debug, and profile iOS and Android apps.

Open-source TypeScript to native Swift compiler for Apple platforms β€” AI agents write 5-15x less code for App Intents, SwiftUI, and WidgetKit.

No reviews yet β€” be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.