29 lines
2 KiB
JSON
29 lines
2 KiB
JSON
{
|
|
"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 <udid>' 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 <udid> screenshot <file>'. 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"
|
|
}
|
|
}
|
|
}
|