MCP Catalogs
← Homemirroir-mcp screenshot

mirroir-mcp

by jfarcand·★ 89·Score 48

MCP server for controlling a real iPhone via macOS iPhone Mirroring with screen analysis and interaction capabilities.

developer-toolsai-llmproductivity
14
Forks
4
Open issues
this month
Last commit
2d ago
Indexed

Overview

mirroir-mcp is a sophisticated MCP server that enables AI agents to interact with iOS applications through macOS iPhone Mirroring. It provides 32 tools for screen description, tapping, swiping, typing, and more, allowing AI agents to observe, reason, and act on iOS interfaces. The server uses multiple screen analysis backends including Apple Vision OCR, YOLO CoreML for icon detection, and an AI vision mode through embacle for semantic UI understanding. It supports skill development through SKILL.md files and can generate skills through autonomous exploration.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

you:Automated UI testing of iOS applications through AI agents
you:Cross-platform automation between iOS and messaging apps
you:Content interaction and posting on iOS social media apps
you:What macOS version is required?
you:How does the AI interact with the iPhone screen?

When to choose this

Choose mirroir-mcp when you need AI agents to interact with iOS apps through a physical iPhone, especially for testing or automation tasks requiring real device interaction.

When NOT to choose this

Don't choose mirroir-mcp if you need Android support, don't have a Mac with iPhone Mirroring, or require non-UI automation like background data processing.

Tools this server exposes

8 tools extracted from the README
  • describe_screen

    Get a detailed description of the iPhone screen with tap coordinates

  • tap

    Tap on a specific screen element using coordinates

  • type_text

    Type text into the currently active field

  • swipe

    Perform a swipe gesture on the screen

  • generate_skill

    Explore an app and generate a reusable skill

  • screenshot

    Take a screenshot of the current screen

  • start_recording

    Start recording screen actions

  • stop_recording

    Stop recording screen actions

Comparable tools

ios-automation-mcpdevice-farmappium-mcp

Installation

Install via script: /bin/bash -c "$(curl -fsSL https://mirroir.dev/get-mirroir.sh)"

Or via npx: npx -y mirroir-mcp install

Or via Homebrew: brew tap jfarcand/tap && brew install mirroir-mcp

For Claude Desktop, add to ~/.claude/config.json:

{
  "mcpServers": {
    "mirroir": {
      "command": "npx",
      "args": ["-y", "mirroir-mcp"]
    }
  }
}

FAQ

What macOS version is required?
macOS 15+ is required, along with an iPhone connected via iPhone Mirroring.
How does the AI interact with the iPhone screen?
The server uses three backends: Apple Vision OCR for text detection, YOLO CoreML for icon detection, and embacle for AI-powered semantic UI understanding.

Compare mirroir-mcp with

mirroir-mcp vs ultimate_mcp_servermirroir-mcp vs mcp-server-chartmirroir-mcp vs everythingmirroir-mcp vs filesystemmirroir-mcp vs time
GitHub →

Last updated · Auto-generated from public README + GitHub signals.