Claude Code

Build Preflight

If you haven’t already, clone and build the server:

git clone https://github.com/EthanAckerman-git/Preflight.git
cd Preflight
npm install
npm run build

Add Preflight to Claude Code

Choose one of two methods:

CLI command
.mcp.json config file

Run this command, replacing the path with the actual location of your Preflight clone:

claude mcp add preflight node /path/to/Preflight/dist/index.js

Claude Code registers Preflight as a global MCP server immediately.

Create or edit .mcp.json in your project root:

{
  "mcpServers": {
    "preflight": {
      "command": "node",
      "args": ["/path/to/Preflight/dist/index.js"],
      "env": {
        "LOG_LEVEL": "info",
        "PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

Replace /path/to/Preflight/dist/index.js with the absolute path on your machine.

If you installed idb via pip, add your Python bin directory to PATH. For example: /opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:~/Library/Python/3.x/bin

Verify the connection

Start (or restart) Claude Code. Run the following prompt to confirm Preflight is connected:

List available MCP tools

You should see Preflight’s tools listed — simulator_screenshot, simulator_snapshot, simulator_tap, and 54 more.

Test prompts

Once connected, try these prompts to confirm everything is working:

List all available iOS simulators.

Use simulator_snapshot before simulator_screenshot whenever possible. The snapshot returns a structured accessibility tree that models can read without a vision model, saving tokens.

Installation

Cursor

Get Started

IDE Setup

Configuration

Test prompts

Build docs developers (and LLMs) love

Get Started

IDE Setup

Configuration

​Test prompts

Build docs developers (and LLMs) love

Test prompts