{ "mcpServers": { "maestro": { "command": "maestro", "args": [ "mcp" ], "description": "Maestro mobile/web UI automation: list devices, drive and inspect the screen, run YAML flows locally or on Maestro Cloud." } }, "_notes": { "added": "2026-10-18 (FR-2026-10-18-01 regression run)", "known_issues": [ "MCP can wedge with 'Device became unreachable during deviceInfo'. Later calls then fail instantly because the failure state is cached, so retrying does not help.", "Observed cause: a stale/duplicate 'maestro.cli.AppKt mcp' java process and/or stale '~/.maestro/deps/simulator-server ios --id ' children. Killing the simulator-server children alone did not recover it.", "Recovery that worked: kill the java process running 'maestro.cli.AppKt mcp' (pgrep -f 'maestro.cli.AppKt mcp'). pi respawns it on the next tool call; list_devices and run then work again.", "After a respawn the Maestro Viewer URL changes (seen at http://127.0.0.1:10000/ and http://127.0.0.1:9999/). Surface the URL from the tool output instead of hardcoding it.", "take_screenshot returns null content on iOS (the image is still shown to the assistant). On iOS prefer 'xcrun simctl io screenshot '. On the 'chromium' device take_screenshot returns real base64 image content.", "Maestro text matchers are FULL-STRING regex with IGNORE_CASE: text 'Foo' does not match 'Foo bar'. Use '.*Foo.*' or an anchored regex.", "React Native placeholders are not accessibility text nodes (e.g. the cart's 'Select a coupon'); tap/assert those by point.", "Leftover modals (Remove Item / Delete Address / iOS Save Password) silently block every subsequent tap in a flow; dismiss them explicitly.", "The MCP server is a long-lived JVM; after heavy flow churn restart it before starting a new batch." ], "device_ids": { "ios_simulator": "5A64695E-F4D4-4E2E-90F3-EC3493A2B457", "web": "chromium" } } }