@cultivx/mobile-xray-mcp v0.0.2

Mobile Xray MCP

🔬 Take screenshots and analyze your mobile apps with AI assistance - right from your IDE.

Privacy First • Built by Developers for Developers • Works Locally

About

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.

Features

• 🔒 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

How to Use

Prerequisites

You need to have Node.js 18+ installed to use the Mobile Xray MCP server.

For iOS Development:

• Install Xcode Command Line Tools: xcode-select --install
• Xcode with iOS Simulator support

For Android Development:

• Install Android Studio (which includes adb and emulator commands)
• Ensure Android SDK tools are in your PATH

Setup Instructions

For Cursor: See Cursor MCP Documentation

For Claude Desktop: See Claude MCP Quickstart

For Windsurf: See Windsurf MCP Documentation

For VS Code: See VS Code MCP Documentation

Note: This MCP server works with any AI coding assistant that supports the Model Context Protocol.

Configuration

Add the following to your MCP configuration file:

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

Basic Usage

1. Start your mobile simulator/emulator
2. Open your AI chat in your IDE
3. Ask for a screenshot: "Can you take a screenshot of my iOS simulator?"
4. Get AI analysis: "What can I improve about this screen's UX?"

Current Features

✅ Platform Detection: Automatically checks which mobile platforms are available on your system

✅ Privacy First: All processing happens locally - no data sent to external servers

✅ Screenshot Capture: Take instant screenshots of iOS simulators and Android emulators

✅ Device Management: List and manage available simulators and emulators

✅ Cross-Platform Support: Works with both iOS and Android development environments

✅ IDE Integration: Seamlessly works with popular AI-powered IDEs and coding assistants

Next Features

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

Contributing

We welcome contributions! Here's how you can help:

1. Fork this repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

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

License

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

Support

• 🐛 Issues: GitHub Issues
• 📖 Documentation: Model Context Protocol Docs

Made with ❤️ by developers, for developers