==================
/// MCP ///
/// IOS ///
==================
[server:online]
[protocol:ready]ios-simulator-mcp
by joshuayoes
MCP server for interacting with the iOS simulator (iOS Simulator MCP Server).
813
34
Specialized01
screenshot
Take a screenshot of the current iOS simulator screen
02
record_video
Start recording a video of the iOS simulator screen
03
stop_recording
Stop the current video recording of the iOS simulator screen
Installation
Prerequisites
1. macOS with Xcode installed (so the `xcrun simctl` CLI and iOS Simulator are available).
2. Node.js ≥ 18 and npm (or yarn / pnpm).
Quick install (global CLI)
# 1. Install from npm (recommended)
npm install -g ios-simulator-mcp # or: yarn global add ios-simulator-mcp
# 2. Launch the MCP server (default port 8301)
ios-sim-mcp start # exposes MCP HTTP/WS endpointsFrom source
# 1. Clone repository
git clone https://github.com/joshuayoes/ios-simulator-mcp.git
cd ios-simulator-mcp
# 2. Install dependencies
npm install # or pnpm install / yarn install
# 3. Optional: build TypeScript → JS
npm run build
# 4. Start the server (defaults to 0.0.0.0:8301)
npm startConfiguration
- `PORT` – override the listening port (default 8301).
- `SIM_DEVICE` – UDID or runtime/name of the simulator to target; if omitted the first booted device is used.
- `MCP_TOKEN` – (optional) shared secret; if set, requests must include `Authorization: Bearer <token>`.
Docker (head-less CI)
docker build -t ios-sim-mcp .
docker run --privileged -p 8301:8301 -e SIM_DEVICE="iPhone 14" ios-sim-mcpAfter the server is running, connect a client or another MCP-aware tool to `http://localhost:8301` (or the chosen port).
Documentation
License: MIT License
Updated 7/30/2025