接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
npx -y [email protected]Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
claude mcp add io.github.ethanackerman-git-preflight-ios-mcp -- npx -y preflight-ios-mcp@1.0.1在終端機中執行。
{ "mcpServers": { "io.github.ethanackerman-git-preflight-ios-mcp": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
遠端 URL 還是本機指令？ 兩種安裝方式的差異
來自發布者
The most comprehensive MCP (Model Context Protocol) server for iOS Simulator automation. Gives AI agents like Claude, ChatGPT, Cursor, Windsurf, and any MCP-compatible tool full control over iOS Simulators — tap, swipe, type, read accessibility trees, inspect app data, capture screenshots, record video, manage devices, and debug apps in real time.
82 tools across 14 categories. Zero cursor interference — works silently in the background while you use your Mac.
57 tools for AI-powered iOS Simulator automation — tap, swipe, type, screenshots, and more.
Inspired by Playwright MCP for web automation — Preflight brings the same structured accessibility-first approach to iOS.
browser_snapshot, use simulator_snapshot to understand the screen without vision models.brew tap facebook/fb
brew install idb-companion
pip3 install fb-idb
Without idb, the server falls back to CGEvent mouse injection (works but briefly moves your cursor).
npm install -g preflight-ios-mcp
git clone https://github.com/EthanAckerman-git/Preflight.git
cd Preflight
npm install
npm run build
Add your Python bin directory to
PATHif idb was installed via pip (e.g.,~/Library/Python/3.x/bin).
claude mcp add preflight -- npx preflight-ios-mcp
Or add to .mcp.json in your project root:
{
"mcpServers": {
"preflight": {
"command": "npx",
"args": ["preflight-ios-mcp"],
"env": {
"PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"
}
}
}
}
Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per-project):
{
"mcpServers": {
"preflight": {
"command": "npx",
"args": ["preflight-ios-mcp"],
"env": {
"PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"
}
}
}
}
Then in Cursor: Settings → MCP — verify "preflight" shows as connected.
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"preflight": {
"command": "npx",
"args": ["preflight-ios-mcp"],
"env": {
"PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"
}
}
}
}
Then in Windsurf: Settings → Cascade → MCP — verify "preflight" appears.
Add to .vscode/mcp.json in your project:
{
"servers": {
"preflight": {
"command": "npx",
"args": ["preflight-ios-mcp"],
"env": {
"PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"
}
}
}
}
For Cline (VS Code extension), add to ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json:
{
"mcpServers": {
"preflight": {
"command": "npx",
"args": ["preflight-ios-mcp"],
"env": {
"PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"
}
}
}
}
Add to ~/.config/zed/settings.json:
{
"context_servers": {
"preflight": {
"command": {
"path": "npx",
"args": ["preflight-ios-mcp"],
"env": {
"PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"
}
}
}
}
}
Preflight uses the standard MCP stdio transport. Configure your client to run:
npx preflight-ios-mcp
Set the PATH environment variable to include idb's location for cursor-free touch injection.
src/
├── index.ts # MCP server entry, 82 tool registrations
├── helpers/
│ ├── idb.ts # Facebook idb CLI wrapper (cursor-free touch)
│ ├── simctl.ts # xcrun simctl command wrapper
│ ├── applescript.ts # Keyboard input + CGEvent fallback
│ ├── coordinate-mapper.ts # Simulator points → macOS screen coords
│ ├── mouse-events.swift # Native Swift CGEvent binary (fallback)
│ └── logger.ts # Structured stderr logging
└── tools/
├── screenshot.ts # JPEG capture optimized for AI chat
├── interaction.ts # Tap, swipe, long press, type, key
├── device.ts # Boot, shutdown, erase, open URL
├── app.ts # Install, launch, terminate, list
├── system.ts # Location, push, clipboard, media, permissions
├── ui.ts # Appearance, status bar, video recording, navigate back
├── debug.ts # Logs, files, crash reports, accessibility
├── advanced.ts # Dynamic Type, keychain, iCloud, biometric, defaults, accessibility, rotation, locale
├── storekit.ts # StoreKit testing — transactions, subscriptions, eligibility
├── network.ts # Network conditioning (dnctl/pfctl) and capture
├── profiling.ts # Memory profiling — leaks, heap, vmmap, sample, thermal
└── playwright.ts # Snapshot, wait_for_element, element_exists
Accessibility-first, like Playwright MCP:
simulator_snapshot to understand the screen (structured text, no vision model)simulator_tap, simulator_swipe, etc.simulator_screenshot when you need visual verificationsimulator_wait_for_element before interacting with elements that appear after transitionsNo disk clutter:
savePath parameter if you actually need files on disksimulator_tap(x=200, y=400)
│
├─ idb available? ──YES──► idb ui tap --udid <UDID> 200 400
│ (IndigoHID → real iOS touch event)
│ (zero cursor movement)
│
└─ idb unavailable? ──► coordinate mapper → macOS screen coords
→ Swift CGEvent binary → mouse down/up
A SwiftUI demo app is included in demo-app/ for testing all MCP features:
cd demo-app
xcodebuild -project MCPDemo.xcodeproj -scheme MCPDemo \
-destination 'platform=iOS Simulator,name=iPhone 16 Pro' \
build
The demo app has 7 tabs exercising every tool category:
simulator_set_locationsimulator_send_push"Boot the iPhone 16 Pro simulator, install my app at ./build/MyApp.app, launch it, and take a screenshot of the home screen. Then tap the login button, type [email protected] in the email field, and verify the form validation works."
"Take a snapshot of the current screen to see what elements are available. Then tap the button labeled 'Sign In' and wait for the email text field to appear."
"My app is crashing on launch. Check the crash logs for MyApp, then get the last 5 minutes of device logs filtered to the MyApp process."
"Switch to dark mode, take a screenshot, then switch to light mode and screenshot again."
If tools show [CGEvent fallback] instead of [cursor-free]:
which idb or check ~/Library/Python/3.x/bin/idbPATH env varPREFLIGHT_IDB_PATH directlyopen -a Simulatorsimulator_boot or xcrun simctl boot "iPhone 16 Pro"npm run dev # Watch mode (TypeScript only)
npm run build # Full rebuild (TypeScript + Swift binary)
node dist/index.js # Run directly
MIT License — see LICENSE for details.
57 tools for AI-powered iOS Simulator automation — tap, swipe, type, screenshots, and more.
{ "mcpServers": { "io.github.ethanackerman-git-preflight-ios-mcp": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式，而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Preflight Ios 透過 stdio 在本機執行。
上次檢查時間：2026-11-09。 57 tools for AI-powered iOS Simulator automation — tap, swipe, type, screenshots, and more.