Scrcpy MCP Server
by juancfio.github.JuanCF/scrcpy-mcpv0.5.0
MCP server for Android device control via ADB and scrcpy — gives AI agents vision and control over Android devices
context tax
queued
security
queued
cold start
queued
freshness
Active17d ago
Install Scrcpy MCP server
Install in Claude Code
claude mcp add scrcpy -- npx -y scrcpy-mcpInstall in Cursor
{
"mcpServers": {
"scrcpy": {
"command": "npx",
"args": [
"-y",
"scrcpy-mcp"
]
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"scrcpy": {
"command": "npx",
"args": [
"-y",
"scrcpy-mcp"
]
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"scrcpy": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"scrcpy-mcp"
]
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"scrcpy": {
"command": "npx",
"args": [
"-y",
"scrcpy-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| ANDROID_SERIAL | — | — | Target device serial number (from `adb devices`). Required when multiple devices are connected. |
| ADB_PATH | — | — | Custom path to the adb binary. Defaults to 'adb' on PATH. |
| SCRCPY_SERVER_PATH | — | — | Path to the scrcpy-server.jar file. Only needed if not installed in a standard location. |
Freshness
Active — last maintenance signal 17d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-23 · 17d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-08-21 · 50d ago · official registry · v0.5.0
FAQ
›How do I install the Scrcpy MCP server in Claude Code?
Run: claude mcp add scrcpy -- npx -y scrcpy-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Scrcpy require an API key?
No required environment variables are declared in its published metadata.
›Can I use Scrcpy as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Scrcpy in the official MCP registry?
Yes, as io.github.JuanCF/scrcpy-mcp.