How do I install the scrcpy mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `SCRCPY_SERVER_PATH`, `SCRCPY_SERVER_VERSION`, `FFMPEG_PATH`, `FFPLAY_PATH` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Scrcpy MCP Server

MCP server for Android device control via ADB and scrcpy

Local serverstdio

What is the Scrcpy MCP Server?

MCP server for Android device control via ADB and scrcpy

What the server does

MCP server that gives AI agents full vision and control over Android devices via ADB and scrcpy.

36 tools — covering screenshots, input, apps, UI automation, shell, files, clipboard, and video streaming
scrcpy-first — uses scrcpy's binary control protocol for 10-50x faster input and near-instant screenshots (~33ms)
ADB fallback — every tool works without scrcpy — slower but always available
Image-returning screenshots — the AI actually sees the screen, not just a file path
UI element finding — ui_find_element returns tap coordinates so the AI can act on what it sees
Clipboard that works on Android 10+ — scrcpy bypasses the restrictions that break ADB-only solutions

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
scrcpy-first	uses scrcpy's binary control protocol for 10-50x faster input and near-instant screenshots (~33ms)
scrcpy	[github.com/Genymobile/scrcpy](https://github.com/Genymobile/scrcpy/releases)
ffmpeg	apt install ffmpeg / brew install ffmpeg
start_session	Start a scrcpy session. When active, input and screenshots use the fast path (10-50x faster).
stop_session	Stop the scrcpy session. Tools fall back to ADB.
start_video_stream	Start an HTTP MJPEG video stream and open an ffplay viewer window. Auto-starts a scrcpy session if needed.
stop_video_stream	Stop the video stream and close the viewer window.
device_list	List all connected devices with serial, state, and model
device_info	Get model, Android version, screen size, SDK level, battery
screen_on	Wake the device screen
screen_off	Turn the screen off
rotate_device	Rotate the screen (requires active session)

How to install the Scrcpy MCP Server

claude mcp add scrcpy --env SCRCPY_SERVER_PATH=your-value --env SCRCPY_SERVER_VERSION=your-value --env FFMPEG_PATH=your-value --env FFPLAY_PATH=your-value -- npx -y scrcpy-mcp

Configuration

Variable	Description	Required
SCRCPY_SERVER_PATH	Filesystem location the server is allowed to use.	Optional
SCRCPY_SERVER_VERSION	Configuration value read at startup.	Optional
FFMPEG_PATH	Filesystem location the server is allowed to use.	Optional
FFPLAY_PATH	Filesystem location the server is allowed to use.	Optional

Example prompts to try

“Use Scrcpy to scrcpy-first.”
“Use Scrcpy to Image.”
“Use Scrcpy to Requirement.”

Frequently asked questions

MCP server for Android device control via ADB and scrcpy Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.

Alternatives to the Scrcpy MCP Server

Filesystem

Official

Read, search and edit files inside allowed directories with the Model Context Protocol reference Filesystem server.

File Systems & StorageTypeScript★ 63.0k

Context7

Official

Retrieve version-aware library documentation and code examples with Context7 MCP, using resolve-library-id and query-docs.

Documentation & API ReferencesRemoteTypeScript★ 32.0k

serphouse-mcp

Run Google, Bing, and Yahoo searches, resolve locations, and query Jobs, Local, Videos, and more — directly from Cursor, VS Code, Claude Desktop, or any MCP-compatible client. No custom API…

Search & Web ScrapingRemote

App Store Connect MCP Server

Configuration examples are included for Codex, Claude Code, Claude Desktop, Gemini CLI, VS Code with GitHub Copilot, Continue, Cursor, and Devin Desktop (formerly Windsurf). Client configuration is…

Developer Tools

Brightsy

Connects to a Brightsy AI agent using the Model Context Protocol.

Developer Tools★ 1

Whois

WHOIS MCP Server - Domain registration lookup using proper WHOIS protocol (port 43). Supports 877+ TLDs with parsing for 169 ccTLDs.

Developer ToolsRemote