Mirroir MCP server

by jfarcand·io.github.jfarcand/mirroir-mcp·v0.39.0

No reviews yet

Control a real iPhone through macOS iPhone Mirroring: screenshot, tap, swipe, type.

C58/100grade C

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

C58/100

full report

Adoption

Established

222 stars202 downloads/wk

Reviews

Write one

Nobody has reviewed Mirroir yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Mirroir tools

No tool declarations could be read from the package source. They show once the server is installed.

Public scan report

scanner v0.1.9 · 2026-09-20 · same rubric, same numbers if you re-run it

1 high2 medium

Code scan5 source files scanned3/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitylocal package, no credentials required12/15
Maintenancelast push 7 days ago15/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Findings (3)

mediumnpm install lifecycle script presentinstall.script

highShell command built from a string (injection risk)exec.shell-concat

install.js: …{ // Extract mirroir-mcp binary execSync(`tar xzf "${tmpFile}" -C "${binDir}"`, { stdio: "inherit" }); /…

mediumnpm install lifecycle script presentinstall.script

package.json: …in/mirroir-mcp" }, "scripts": { "postinstall": "node install.js" }, "files": [ …

Overall 58/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

What the publisher says

From the Mirroir repository's README, as published. We do not edit it. Read it on GitHub

mirroir-mcp

Give your AI eyes, hands, and a real iPhone. An MCP server that lets any AI agent see the screen, tap what it needs, and figure the rest out — through macOS iPhone Mirroring. Experimental support for macOS windows. 33 tools, any MCP client.

Requirements

macOS 15+
iPhone connected via iPhone Mirroring

Install

/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

The first time you take a screenshot, macOS will prompt for Screen Recording and Accessibility permissions. Grant both.

Per-client setup

Claude Code

claude mcp add --transport stdio mirroir -- npx -y mirroir-mcp

GitHub Copilot (VS Code)

Install from the MCP server gallery: search @mcp mirroir in the Extensions view, or add to .vscode/mcp.json:

{
  "servers": {
    "mirroir": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mirroir-mcp"]
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

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

OpenAI Codex

codex mcp add mirroir -- npx -y mirroir-mcp

Or add to ~/.codex/config.toml:

[mcp_servers.mirroir]
command = "npx"
args = ["-y", "mirroir-mcp"]

Install from source

git clone https://github.com/jfarcand/mirroir-mcp.git
cd mirroir-mcp
./mirroir.sh

Use the full path to the binary in your .mcp.json: /.build/release/mirroir-mcp.

How it works

Every interaction follows the same loop: observe, reason, act. describescreen gives the AI every text element with tap coordinates (eyes). The LLM decides what to do next (brain). tap, typetext, swipe execute the action (hands) — then it loops back to observe. No scripts, no coordinates, just intent.

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Install directly

Runs npx -y mirroir-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add mirroir-mcp -- npx -y mirroir-mcp

Add to Cursor

Mirroir: common questions

Is Mirroir MCP server safe?: With care: it is graded C, so read the findings first (58/100). Read the Mirroir safety report
How do I install Mirroir?: It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
Does Mirroir need an API key?: Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Mirroir maintained?: The last commit was 7 days ago (2026-09-13). The latest release is v0.39.0.
What can I use instead of Mirroir?: Servers from other publishers that do the same job: ExecBro MCP server.

Alternatives to Mirroir

Same job from other publishers: the closest match first, then the best rated.

ExecBro
Gives AI agents eyes and hands into running React Native apps: logs, REPL, tap, screenshots
not reviewed
Established
A