Loading...

An MCP server for interacting with iOS Simulators, enabling UI testing and automation via tool calls for tasks like tapping, typing, and screen capture.
Boost this tool
Subscribe to listing upgrades or segmented pushes.
An MCP server for interacting with iOS Simulators, enabling UI testing and automation via tool calls for tasks like tapping, typing, and screen capture.
This server is relatively safe for read-only operations and basic UI interactions. However, caution should be exercised when using tools that modify the simulator's state or access the file system. Ensure the server is updated to the latest version to mitigate known vulnerabilities.
Performance depends on the complexity of the UI and the speed of the host machine. Operations like screenshot and video recording can be resource-intensive.
There are no direct monetary costs associated with using this server. However, resource usage (CPU, memory, disk space) should be considered, especially for long-running tasks like video recording.
{
"mcpServers": {
"ios-simulator": {
"command": "npx",
"args": ["-y", "ios-simulator-mcp"],
"env": {
"IOS_SIMULATOR_MCP_FILTERED_TOOLS": "screenshot,record_video,stop_recording",
"IOS_SIMULATOR_MCP_DEFAULT_OUTPUT_DIR": "~/Code/awesome-project/tmp",
"IOS_SIMULATOR_MCP_IDB_PATH": "~/bin/idb"
}
}
}
}get_booted_sim_idRetrieves the ID of the currently running iOS simulator.
Read-only operation with no side effects.
open_simulatorOpens the iOS Simulator application.
Simple action that does not modify system state.
ui_describe_allDescribes accessibility information for the entire screen.
Read-only operation; provides information about UI elements.
ui_tapSimulates a tap on the screen at specified coordinates.
Performs UI interaction, but does not modify system files.
ui_typeInputs text into the iOS Simulator.
Performs UI interaction, but input is limited to ASCII characters.
ui_swipeSimulates a swipe gesture on the screen.
Performs UI interaction, but does not modify system files.
ui_describe_pointReturns accessibility element information at given coordinates.
Read-only operation; provides information about a UI element.
ui_viewGets a compressed screenshot of the current simulator view.
Captures the screen, but does not modify any files.
screenshotTakes a screenshot of the iOS Simulator and saves it to a file.
Writes a file to the file system, but the location is configurable.
record_videoRecords a video of the iOS Simulator.
Writes a video file to the file system; location is configurable.
stop_recordingStops the simulator video recording.
Terminates a process, but does not modify system files.
install_appInstalls an app bundle on the iOS Simulator.
Installs applications, potentially introducing malicious code.
launch_appLaunches an app on the iOS Simulator by bundle identifier.
Launches applications, which could have unintended consequences.
None
cloud
This server is relatively safe for read-only operations and basic UI interactions. However, caution should be exercised when using tools that modify the simulator's state or access the file system. Ensure the server is updated to the latest version to mitigate known vulnerabilities.
The level of autonomy should be carefully considered, especially when using tools that can install or launch applications. Sandboxing provides a degree of isolation, but it's not a complete security solution.
Production Tip
Always validate the output of tools, especially those that modify the simulator's state, before proceeding with further actions.
It allows you to interact with iOS Simulators programmatically for UI testing, automation, and other tasks.
You need Node.js, macOS, Xcode with iOS simulators, and Facebook IDB.
Use the `install_app` tool and provide the path to the app bundle (.app or .ipa).
Use the `screenshot` tool and specify the output path and image format.
Use the `record_video` tool. You can optionally specify the output path and codec.
It's `~/Downloads`, unless overridden by the `IOS_SIMULATOR_MCP_DEFAULT_OUTPUT_DIR` environment variable.
It's relatively safe for basic operations, but be cautious with tools that modify the simulator's state or access the file system. Always keep the server updated to the latest version.