scrcpy MCP Server

Local MCP server that exposes Android device control via adb and scrcpy as 22 tools for MCP clients like Claude Code and Codex CLI.

Quick Start

One command — no prerequisites needed (the installer handles everything):

curl -fsSL https://raw.githubusercontent.com/charettep/scrcpy-mcp/main/install.sh | bash

Or from a local clone:

git clone https://github.com/charettep/scrcpy-mcp.git && cd scrcpy-mcp
./install.sh

The installer will:

1. Detect your OS and package manager (apt, dnf, pacman, brew)

2. Download the repo to ~/mcp/scrcpy-mcp (if running via curl)

3. Check for adb, scrcpy, and uv — install any that are missing

4. Find Python 3.10+ and create an isolated venv with dependencies

5. Detect installed MCP clients (Claude Code, Codex CLI)

6. Ask where to register the server:

   • Global — injects config directly into ~/.claude.json and/or ~/.codex/config.toml

   • Project — generates a local .mcp.json file

Re-running the installer is safe — it updates the existing install and overwrites old config entries.

Related MCP server: adb-mcp-server

Prerequisites

• Python 3.10+

• adb (from Android SDK platform-tools)

• scrcpy (for mirroring/recording sessions)

• An Android device with USB debugging enabled

The installer handles all of the above automatically.

Manual Install

If you prefer not to use the installer:

uv venv .venv && uv pip install -r requirements.txt

Then add to your project .mcp.json:

{
  "mcpServers": {
    "scrcpy": {
      "command": "/path/to/.venv/bin/python",
      "args": ["/absolute/path/to/scrcpy_mcp.py"],
      "env": {
        "SCRCPY_MCP_ADB_PATH": "/usr/bin/adb",
        "SCRCPY_MCP_SCRCPY_PATH": "/usr/bin/scrcpy"
      }
    }
  }
}

The env block is optional — without it, adb and scrcpy are resolved from PATH.

Available Tools (22)

Device Management

Input Injection

Screen & Display

App Management

Clipboard

File Transfer

Scrcpy Sessions

Multi-device Support

All tools accept an optional serial parameter. If omitted, adb uses the only connected device (or fails if multiple are connected).

tap(x=500, y=1000, serial="ABCD1234")

Environment Variables

These are set automatically by install.sh via the MCP config env block.

Verify

python3 scrcpy_mcp.py  # starts on stdio
python3 -c "from scrcpy_mcp import mcp; print(len(mcp._tool_manager._tools))"  # should print 22