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, report which scrcpy-server version the session pushes and where that version was resolved from, and start an HTTP MJPEG video stream and open a viewer window (ffplay). Auto-starts a scrcpy session if needed.

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

Audio

5 tools - e.g. Stream device audio to the host's speakers via ffplay. Restarts the scrcpy session if it was started without audio.; Stop streaming audio to the host.; Start recording device audio to .wav (default) or…

start_audio_stream · stop_audio_stream · audio_record_start · audio_record_stop · audio_capture

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

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 a viewer window (ffplay). 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

Version

1 tool - e.g. Report which scrcpy-server version the session pushes and where that version was resolved from.

version

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 #50 of 290 actively-maintained browser automation servers as of 2026-09-30.
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-09-30, its last commit was 2026-09-23. 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, report which scrcpy-server version the session pushes and where that version was resolved from, and start an HTTP MJPEG video stream and open a viewer window (ffplay). Auto-starts a scrcpy session if needed.

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 · Deepbom · Accessibility Scanner · Opencut Controller · Power Automate

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