Scrcpy MCP - install, status & alternatives [2026]

01 · Install Scrcpy MCP

before you install - you'll need

Set SCRCPY_SERVER_PATH before connecting.

Claude Code

claude mcp add juancf-scrcpy-mcp -- npx -y scrcpy-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "juancf-scrcpy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "scrcpy-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package scrcpy-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.JuanCF is GitHub-verified and matches the repo owner

03 · What Scrcpy MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can start a scrcpy session. When active, input and screenshots use the fast path (10-50x faster), stop the scrcpy session. Tools fall back to ADB, start an HTTP MJPEG video stream and open an ffplay viewer window. Auto-starts a scrcpy session if needed, and stop the video stream and close the viewer window.

Capability map

Tools grouped from the project's README - what Scrcpy MCP lets an agent do.

App

6 tools - e.g. Launch an app by package name. Prefix with + to force-stop before launch.; Force-stop an app; Install an APK from the host machine

app_start · app_stop · app_install · app_uninstall · app_list · app_current

Screen

4 tools - e.g. Wake the device screen; Turn the screen off; Start recording the screen to a file on the device

screen_on · screen_off · screen_record_start · screen_record_stop

Device

3 tools - e.g. List all connected devices with serial, state, and model; Get model, Android version, screen size, SDK level, battery; Rotate the screen (requires active session)

device_list · device_info · rotate_device

File

3 tools - e.g. Push a file from the host machine to the device; Pull a file from the device to the host machine; List directory contents on the device

file_push · file_pull · file_list

Session

2 tools - e.g. Start a scrcpy session. When active, input and screenshots use the fast path (10-50x faster).; Stop the scrcpy session. Tools fall back to ADB.

start_session · stop_session

Video

2 tools - e.g. Start an HTTP MJPEG video stream and open an ffplay viewer window. Auto-starts a scrcpy session if needed.; Stop the video stream and close the viewer window.

start_video_stream · stop_video_stream

Expand

2 tools - e.g. Pull down the notification panel (requires active session); Pull down the quick settings panel (requires active session)

expand_notifications · expand_settings

Clipboard

2 tools - e.g. Get clipboard content. Uses scrcpy to bypass Android 10+ restrictions.; Set clipboard content. Pass paste: true to also paste immediately.

clipboard_get · clipboard_set

04 · Who maintains Scrcpy MCP

scrcpy-mcp is maintained by juancf. It's the only MCP server we track from this author; the repo dates to Feb 2026.

05 · Facts

repository: github.com/juancf/scrcpy-mcp
category: browser automation - ranked #29 of 196 actively-maintained browser automation servers as of 2026-08-25.
registry: io.github.JuanCF/scrcpy-mcp (active, first published 2026-02-22 · 9 versions)
packages: npm:scrcpy-mcp

06 · Scrcpy MCP FAQ

Is Scrcpy MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-21. We re-verify nightly.

What can Scrcpy MCP do?

With this server connected, an agent can start a scrcpy session. When active, input and screenshots use the fast path (10-50x faster), stop the scrcpy session. Tools fall back to ADB, start an HTTP MJPEG video stream and open an ffplay viewer window. Auto-starts a scrcpy session if needed, and stop the video stream and close the viewer window.

How do I install Scrcpy MCP?

Run `npx -y scrcpy-mcp`. The README documents one environment variable (SCRCPY_SERVER_PATH) to set first. Set SCRCPY_SERVER_PATH before connecting. You can also paste the ready-made client config above.

Does Scrcpy MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Scrcpy MCP

Alternatives to Scrcpy MCP

Maintained browser automation servers if Scrcpy MCP isn't the fit.

Pairs well with

Servers that cover what Scrcpy MCP doesn't - only shown when the pairing reason fits the companion.

More browser automation MCP servers · DrissionPage MCP · Accessibility Scanner · Opencut Controller · Power Automate · Auto Mobile

More TypeScript MCP servers · Sdd MCP · Context Mem · Workflow MCP · Mycal · Obsidian Everywhere · see all