Allows automating Android emulators and physical devices via adb, including device selection, screenshots, accessibility UI tree inspection, touch and text input, app lifecycle management, and log capture.
Allows automating iOS simulators and physical devices via simctl and WebDriverAgent/XCTest, including device selection, screenshots, accessibility UI tree inspection, touch and text input, app lifecycle management, and log capture.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Karagöz Take a screenshot of the Android emulator and show the UI tree."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Device automation for mobile apps. One tool, four targets: Android emulator, Android physical device, iOS simulator, iOS physical device. Works as a CLI, and as an MCP server when you want an AI agent driving it.
Status: early development. Nothing works yet. The design is settled, the code is not written.
Drive a device, observe the screen, touch it, capture what you see.
devices list and select a device
screenshot full resolution, with scale metadata
ui-tree accessibility tree, elements and bounding boxes
tap / swipe / text / key interaction
install / launch / terminate app lifecycle
logs device logsSame commands across all four targets. One interface, four drivers.
Related MCP server: Android-MCP
Not a test framework. No assertions, no test runner, no recorded flows, no retry policy, no reports.
Not a design comparison tool. Figma diffing, measurement and reporting belong a layer above. Karagöz produces the raw input; it does not interpret it.
It is the primitive layer. Each command does one thing and exits.
Karagöz is Turkish shadow puppet theatre. Figures are driven with rods from behind a lit screen while the audience watches the movement on the screen. That is what this tool does.
Target | Transport |
Android emulator |
|
Android device |
|
iOS simulator |
|
iOS device | tunnel plus WebDriverAgent / XCTest |
Android comes first, iOS follows.
Node 22 or newer. Platform tools are detected at runtime, not bundled: adb for Android, Xcode command line tools for iOS.
MIT
This server cannot be deployed
Control real Android and iOS devices with LLM agents — tap, swipe, type, automate flows.
Drive real devices from your AI Coding tool. Embed a client SDK (Unity, Godot, Flutter, iOS/macOS, Android, React Native, Web) in your app, then capture screenshots, traverse the UI tree, inject taps and key events, and run automated test tasks on the physical device over a secure relay.
remote debug iOS/Android/Unity/Godot/Flutter/RN/Web on real-device.ui-tree/screenshots/taps,tests.
Cloud iOS simulators and Android emulators your agent can create, drive, and throw away.
