# StupidMirror

> StupidMirror is an MCP server for browser automation. Let Claude Code or Codex tap, type and verify on a real iPhone or Android device. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** macOS, iOS, Android, CLI
- **Website:** https://stupidmirror.itool.tech/mcp/
- **Repository:** https://github.com/liutianjie/stupidmirror
- **MCP Registry name:** io.github.LiuTianjie/stupidmirror
- **Categories:** [browser automation](https://ai-powered.com/categories/browser-automation), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

StupidMirror is a Mac app that mirrors iPhone and Android devices, simulators and emulators. Its local MCP server lets an AI agent drive them. It listens only on 127.0.0.1, and setup is a one-click Connect Claude Code or Connect Codex in the app's MCP Automation settings. In the Claude desktop app the live phone screen opens in the Browser pane beside the conversation.

The tools cover listing devices, observing the screen, tapping elements or text, typing and replacing text, opening URLs, installing apps, waiting for and asserting on-screen state, highlighting clickable elements and recording.

The site says StupidMirror embeds no model and needs no model API key.

## Features

- **Real and virtual devices:** Controls phones, simulators and emulators.
- **Live viewer:** Shows the phone screen in the Browser pane.
- **Tap and type:** Interacts with elements and text.
- **Assertions and waits:** Verifies on-screen state.
- **Local only:** Listens on localhost.

## Good for

- Test an app flow on a real iPhone
- Install a build and verify a screen
- Record a bug reproduction
- Check a mobile layout on Android

## Install

### Claude Code (Terminal)

```sh
claude mcp add stupidmirror -- npx -y stupidmirror-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "stupidmirror": {
      "command": "npx",
      "args": [
        "-y",
        "stupidmirror-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "stupidmirror": {
      "command": "npx",
      "args": [
        "-y",
        "stupidmirror-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "stupidmirror": {
      "command": "npx",
      "args": [
        "-y",
        "stupidmirror-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "stupidmirror": {
      "command": "npx",
      "args": [
        "-y",
        "stupidmirror-mcp"
      ]
    }
  }
}
```

## Tools

- `list_devices`: Lists connected devices.
- `observe_screen`: Reads the current screen.
- `tap_element`: Taps an element.
- `tap_text`: Taps visible text.
- `type_text`: Types text.
- `clear_text`: Clears a text field.
- `replace_text`: Replaces text.
- `open_url`: Opens a URL.
- `install_app`: Installs an app.
- `wait_for`: Waits for a screen condition.
- `assert_screen`: Asserts screen state.
- `find_any_element`: Finds an element.
- `highlight_clickable_elements`: Highlights clickable elements.
- `highlight_elements`: Highlights elements.
- `show_screen`: Shows the device screen.
- `start_recording`: Starts a screen recording.
- `connect_control`: Connects control to a device.

## FAQ

### Does it need an API key?

No, it embeds no model.

### Which clients connect?

Claude Code and Codex with one click; others use generated configuration.

### Where does the server listen?

Only on http://127.0.0.1:<port>/mcp.

### What runs it?

The StupidMirror Mac app.

### How do I add StupidMirror to Claude Code?

Run this command in your terminal: claude mcp add stupidmirror -- npx -y stupidmirror-mcp

### What are the best alternatives to StupidMirror?

The closest alternatives to StupidMirror are REA, Browser Use, Scrapling MCP Server, Context7 and Chrome DevTools MCP.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/stupidmirror
