android-mcp-beta
Clean-room reimplementation of Android-MCP: an MCP server that lets an AI agent operate an Android device over ADB.
It needs only adb. Nothing is installed on the device, and there is no dependency on
uiautomator2.
Power your agent
Yayıncıdan kurulum. PlugMCP uç noktası değildir.
Host a copy with our keys and logs.
Registry'de henüz paketlenmiş bir sürüm yok. Deponun README dosyasını izleyin.
Uzak URL mi, yoksa makinenizde bir komut mu? İki kurulum arasındaki fark
PlugMCP’de çalıştır
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
BaşlatYayıncıdan
Clean-room reimplementation of Android-MCP: an MCP server that lets an AI agent operate an Android device over ADB.
It needs only adb. Nothing is installed on the device, and there is no dependency on
uiautomator2.
MCP Server for interacting with Android Devices.
Requires Python 3.13 and adb (Android platform-tools).
uv run android-mcp-beta
The server speaks MCP on stdio. In a client's config:
{
"mcpServers": {
"android-mcp-beta": {
"command": "uv",
"args": ["--directory", "D:/Projects/android-mcp-beta", "run", "android-mcp-beta"]
}
}
}
The device is connected on the first tool call, so the server starts whether or not one is attached yet.
With no options it uses the first physical device, or an emulator when there is none.
Options win over the environment. Other variables:
ANDROID_MCP_ADB_PATH names the adb binary. Otherwise adb is looked for on PATH, then in
ANDROID_HOME, ANDROID_SDK_ROOT and the default Android Studio SDK folders.SCREENSHOT_QUANTIZED=true reduces screenshots to 256 colours, which makes them smaller.Type uses adb shell input text, so on its own it types printable ASCII and the accented Latin
letters Android can compose (é ñ ü ÿ and 107 others, not ç ß å ø). A newline presses Enter and a
tab presses Tab. For anything else (CJK, Cyrillic, Arabic, emoji, ç), install the
ADBKeyboard app on the device once:
adb install keyboardservice-debug.apk
Download it from the releases page. This project
does not bundle it: ADBKeyboard is GPL-2.0, and it is only ever talked to over broadcasts. I tested
v2.5-dev (SHA-256 41a8a099…46fbbb) on Android 15.
With it installed, text that input text cannot type is sent through it automatically. For about
a second the device's keyboard is switched to ADBKeyboard, which shows no keyboard of its own, and
then the keyboard that was active before is put back (and ADBKeyboard is disabled again if it was
not enabled). A text field must be focused, or the call fails with an error saying so. If a crash
ever leaves the device on ADBKeyboard, adb shell ime reset restores the default. Without the app,
such text is rejected before anything is sent, with these instructions in the error.
uiautomator dump, which gives up when the screen
never goes idle (a video, a running timer). Snapshot with use_vision then returns the
screenshot alone and says so; click by coordinates still works.input keycombination, which needs
Android 12; older devices fall back to a slower method that clears up to 200 characters.uv sync
uv run pytest
uv run ruff check . && uv run ruff format --check .
The tests need no device. Layers, bottom to top: android_mcp.adb (talks to adb),
android_mcp.tree (reads the screen), android_mcp.mobile (one connected device: state and
actions), android_mcp.server (the MCP tools and the choice of device).
MCP Server for interacting with Android Devices.
Araçlar
Henüz araç listesi yok. Uzak sunucular ilk sağlık kontrolünden sonra bir liste alır.
SSS
Bu sayfadan Cursor, Claude Desktop, Claude Code veya VS Code için stdio yapılandırmasını kopyalayın. PlugMCP proxy'sini değil, yayıncının kurulumunu kullanır.
Bu kayıtta gerekli bir ortam değişkeni listelenmiyor.
Android yerel olarak stdio üzerinden çalışır.
Son kontrol: 2026-11-12. MCP Server for interacting with Android Devices.