# simframe

> simframe is an open-source MCP server for developer tools. Fast iOS Simulator and Android emulator screen reading, taps and flows for coding agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS
- **Website:** https://lvlrsajjad.github.io/simframe/
- **Repository:** https://github.com/lvlrsajjad/simframe
- **MCP Registry name:** io.github.lvlrSajjad/simframe
- **Categories:** developer tools
- **Listing updated:** 2026-11-16

## About

An agent driving a simulator is slow for three reasons the project names: every look is a wait, every step is a round trip, and nothing is remembered. simframe keeps frames warm so a look takes about 20 ms, compares changes against the last frame the agent actually observed (not the previous frame, which would miss a 700 ms transition), and can run a whole multi-step flow in one call.

It reads each screen two ways: the accessibility tree for real hit targets, and on-device OCR through Apple's Vision for every visible label with coordinates. The merged result is keyed by a layout hash, so revisiting a screen is a file read. The authors tested on a React Native app whose custom tab bar published no children and found this was needed.

In one measured run on that app, the same model with simframe used 2.5 times fewer tokens and 3.5 times fewer calls, though the agent was still 9 to 10 times slower than a person. Watching needs only Xcode; tapping and typing need `idb`. Install with `npx -y simframe mcp` on a Mac with Node 18 or newer; the first call builds a small Swift daemon in about 15 seconds. Capture stops itself 15 minutes after the last request.

## Features

- **Warm frames:** Keeps screen capture running so reads take about 20 ms.
- **Change baselines:** Reports what changed since the last frame the agent saw.
- **One-call flows:** Runs a multi-step flow in a single tool call.
- **OCR plus accessibility:** Merges visible labels with accessibility targets.
- **Screen memory:** Remembers screens by layout hash so repeat visits are quick.
- **Claude Code plugin:** Optionally installs a Sonnet-driven driver agent and skill.

## Good for

- Let an agent tap through a signup flow in the iOS Simulator
- Check whether a list on a tab has finished loading
- Debug why a button does nothing
- Cut token use when testing a mobile app with an agent

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## FAQ

### What does it need?

A Mac with Xcode and Node 18 or newer; tap, type and swipe also need idb.

### How is it installed?

claude mcp add --scope user simframe -- npx -y simframe mcp, or as a Claude Code plugin.

### How much does it save?

In one benchmarked run, 2.5 times fewer tokens and 3.5 times fewer calls than the same model without it; the README calls it a measured example, not a rate.

### Does it support Android?

The README says it drives an iOS Simulator or an Android emulator.

### Is simframe free?

Yes. simframe is open source, so you can use and self-host it for free.

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

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

### What are the best alternatives to simframe?

The closest alternatives to simframe are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [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.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

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