mirroir-mcp
An MCP server that lets an AI agent see and control a real iPhone through macOS iPhone Mirroring, describing on-screen elements with tap coordinates and executing taps, swipes, and typed text through dozens of tools.
mirroir-mcp gives an AI agent a real device to operate: through macOS's iPhone Mirroring feature, one tool returns every visible text element with tap coordinates, and further tools let the agent tap, type text, and swipe based on what it sees, looping through observe, reason, and act without hand-written scripts or hardcoded coordinates. Higher-level tools handle navigation and lifecycle actions such as tapping back by locating an on-screen label through OCR.
It requires macOS 15 or newer and an iPhone connected through iPhone Mirroring, and needs Screen Recording and Accessibility permissions granted on first screenshot. It installs through a shell script, npx, or Homebrew, with documented setup steps for Claude Code, GitHub Copilot in VS Code, Cursor, and OpenAI Codex.
Game controls are also supported through iPhone Mirroring's touch and gesture passthrough, including virtual joystick-style holds, a keyboard-and-mouse mode for some game titles, and two-finger pinch and rotate gestures.