iOS Simulator MCP 1.6.0

Features

• ui_find_element Tool: New tool that searches the accessibility tree by label, unique identifier, and/or element type with configurable substring/exact matching and case sensitivity. Returns only matching elements instead of the full tree, dramatically reducing token usage in agent loops. Thanks @kattouf! (#51)

  https://github.com/user-attachments/assets/d108eefe-9784-4560-9048-aab67e9769a5

• launch_app Environment Variables: Added an optional env parameter to launch_app that passes Record<string, string> entries to the target app via SIMCTL_CHILD_* environment variables at launch. Useful for feature flags, test fixtures, and dynamic configuration without rebuilding. Thanks @markgrover! (#47)

• record_video UDID Support: The record_video tool now accepts an optional udid parameter instead of hardcoding "booted", enabling targeted recording when multiple simulators are running. Thanks @saen-ai! (#59)

Improvements

• ui_view Robustness: Wrapped JSON.parse of idb output in error handling so the MCP server returns a clear error instead of crashing on malformed output. Added validation that screen frame dimensions are positive numbers.
• ui_view Temp File Cleanup: Raw and compressed screenshot files are now deleted immediately after the image is read into memory instead of accumulating until process exit. Filenames include a random suffix to avoid collisions on rapid successive calls.
• record_video Startup Detection: Added an exit listener so record_video rejects promptly with the captured stderr if the capture process dies during startup, instead of silently resolving after the timeout. Startup timeout bumped from 3s to 5s for slower machines.
• SDK Dependency Alignment: Upgraded @modelcontextprotocol/sdk to ^1.29.0 and aligned zod to ^3.25.0 to match the SDK's peer dependency range.

Documentation

• CLAUDE.md Doc References: Added a section pointing to README, CONTRIBUTING, QA, TROUBLESHOOTING, SECURITY, and CONTEXT files. (#48)
• README claude mcp add Syntax: Corrected the claude mcp add command syntax in the README. Thanks @shmkane! (#45)
• record_video UDID Docs: Documented the new udid parameter in the README tool reference.

Build

• Version Bump: Updated the project version to 1.6.0.