emulator-hub
Allows agents to lease and interact with Android emulators from a shared pool, providing exclusive bounded access to running emulator instances and the ability to release or observe sessions.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
A lease-based pool of self-hosted Android emulators for agents and humans.
Check out a phone, tablet, or TV over MCP or HTTP, use it exclusively for a bounded lease, then release it back to the pool.
Demo
Related MCP server: ARTEMIS MCP Server
Install
Berth runs on Kubernetes: the hub server starts one emulator Pod per lease.
docker pull ghcr.io/noahchalifour/emulator-hub:v0.1.1Deployment manifests live in home-lab-infrastructure. Set HUB_API_TOKEN, HUB_EMULATOR_IMAGE, and HUB_SLOT_IPS on the hub.
Quickstart
Point an MCP client at the machine port (8081) and let the agent lease a device:
claude mcp add --transport http berth http://localhost:8081/mcp \
--header "Authorization: Bearer $HUB_API_TOKEN"Ask the agent to call acquire with a profile such as phone. The grant returns the lease id, the adb address to adb connect to, and expires_at. Call release when you finish, or let the lease expire.
Leases over MCP or HTTP
MCP tools:
list_profiles,acquire,heartbeat,release, andstatusover streamable HTTP at/mcp.Bounded leases: Each lease has a TTL, extends with
heartbeat, and hits a hard stop after four hours.REST API: Manage leases and profiles at
/api/leasesand/api/profiles.Metrics: Scrape Prometheus metrics at
/metricsand probe/healthz.
Live view and takeover
Watch any active session in the browser and take over with touch, keyboard, and the Back, Home, Recents, volume, and power buttons.
Profiles and history
Form factors: Phone, tablet, and Android TV profiles ship by default.
Editable profiles: Choose the system image, device, RAM (1024 to 4096 MB), and cores (1 to 4) per profile.
Lease history: Review the last 100 leases with holder, duration, and how each ended.
Android TV adb key
android-tv images only trust the key the emulator pushes at boot. Give the hub one key pair for every emulator:
adb keygen adbkey
kubectl -n emulator-hub create secret generic emulator-hub-adb-key \
--from-file=adbkey --from-file=adbkey.pubMount the Secret into the hub and set HUB_ADB_KEY_DIR to the mount path. Agents fetch the key from GET /adbkey on the machine port. Anyone with the API token can then reach any leased device over adb.
License
MIT. See CONTRIBUTING.md to develop or run the tests.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Disposable cloud Android emulators for coding agents: run an APK or PR build, tap, type, screenshot.
Phones for your agents: each agent gets its own cloud Android phone over MCP, reads the screen, taps, types and installs your APK. Ready in ~20 s, $0.01/min, parked phones free.
Cloud iOS simulators and Android emulators your agent can create, drive, and throw away.
Give your AI agent a real cloud Android phone: push APKs, drive it, get screenshots and logs.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to fully control an Android emulator via MCP, including UI interaction, screenshots, APK installation, logging, and clipboard access, with optional live browser viewing for humans.2MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants and test suites to drive real Android devices or emulators through MCP, executing natural-language automation and testing workflows while collecting screenshots, Logcat output, and device state.Apache 2.0
- AlicenseBqualityBmaintenanceEnables an AI agent to lease its own Android emulator phone and drive it over stdio: reading the screen, tapping, typing, and opening apps, with every action leaving an audit line and screenshot. Leases keep one agent per phone, and a locked phone stays inert until an operator unlocks it on its own screen.10MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to lease clean or signed-in Android emulator clones as adb-accessible devices, list and release them, and optionally open a scrcpy mirror, with short-lived leases that can be reclaimed after a client reconnects.MIT