runner-mcp-bridge
v0.2.0
Published
MCP-style interactive bridge for real iOS devices via maestro-runner
Maintainers
Readme
runner-mcp-bridge
MCP-style step-by-step control for a real iOS device using maestro-runner.
Install / Run
npx runner-mcp-bridge --helpUse as MCP server (Cursor)
Run MCP mode:
npx runner-mcp-bridge mcpCursor MCP config example:
{
"mcpServers": {
"runner-mcp-bridge": {
"command": "npx",
"args": ["-y", "[email protected]", "mcp"]
}
}
}Init
npx runner-mcp-bridge init \
--udid 00008020-000454342E23002E \
--team-id ZG8SP9DGX5 \
--app-id org.reactjs.native.RDNRCommands
statusinspectlaunchstoptap --text "Continue with Apple"tap --id "login_button"swipe --direction up|down|left|rightpress --key homescreenshot --name current-screenshell(interactive mode)
Notes
- Requires
maestro-runnerinstalled and available in PATH. - Device must be unlocked for WDA startup.
- Stores bridge state in
.runner-mcp-bridge/in current directory.
