scrcpy-mcp
local MCP serverscrcpy-mcp is a local MCP server: MCP server for Android device control via ADB and scrcpy. Install it from npm as scrcpy-mcp.
Installation
Terminal
claude mcp add scrcpy-mcp -e ANDROID_SERIAL=... -e ADB_PATH=... -e SCRCPY_SERVER_PATH=... -- npx -y scrcpy-mcp
Run in your project folder. Add --scope user to use it everywhere.
Claude Desktop, Cursor & other clients
Add to claude_desktop_config.json or .cursor/mcp.json.
{
"mcpServers": {
"scrcpy-mcp": {
"command": "npx",
"args": [
"-y",
"scrcpy-mcp"
],
"env": {
"ANDROID_SERIAL": "...",
"ADB_PATH": "...",
"SCRCPY_SERVER_PATH": "..."
}
}
}
}Fill in the environment variables with your own credentials.
What you need
- Runtime: Node.js 18+ (runs with npx).
- MCP client: Claude Code, Codex, Antigravity, Claude Desktop, Cursor or any other client that speaks MCP over stdio.
- Environment variables:
ANDROID_SERIAL,ADB_PATH,SCRCPY_SERVER_PATH
Summary
MCP server for Android device control via ADB and scrcpy
scrcpy-mcp vs similar servers
| Server | Stars | Type | API key | Runtime |
|---|---|---|---|---|
| scrcpy-mcp | 108 | Local | Yes | npm |
| agent-device | 4,793 | Local | No | npm |
| mobilerun | 9,489 | Hosted | Yes | None |
| mobile-mcp | 8,023 | Local | No | npm |
| agent-device | 4,793 | Local | No | npm |
Questions
It reads 3 environment variables: ANDROID_SERIAL, ADB_PATH, SCRCPY_SERVER_PATH. Set them in your MCP config before starting the server.
Node.js 18+ (runs with npx), plus an MCP client such as Claude Code, Codex, Claude Desktop or Cursor.
scrcpy-mcp is a local MCP server distributed as the npm package scrcpy-mcp.
Run: claude mcp add scrcpy-mcp -e ANDROID_SERIAL=... -e ADB_PATH=... -e SCRCPY_SERVER_PATH=... -- npx -y scrcpy-mcp
Run: codex mcp add scrcpy-mcp --env ANDROID_SERIAL=... --env ADB_PATH=... --env SCRCPY_SERVER_PATH=... -- npx -y scrcpy-mcp
Similar MCP servers
NameStars
- agent-deviceio.github.callstack/agent-device4,793
- mobilerunio.github.droidrun/mobilerun9,489
- mobile-mcpio.github.mobile-next/mobile-mcp8,023
- agent-deviceio.github.callstackincubator/agent-device4,793
- DBHubio.github.bytebase/dbhub3,574
- ChiR24-unreal_mcp_serverai.smithery/ChiR24-unreal_mcp_server891
- touchdesigner-mcp-serverio.github.8beeeaaat/touchdesigner-mcp-server552
- photoshop-mcpio.github.alisaitteke/photoshop-mcp527