io.github.JuanCF/scrcpy-mcp
NPM · SCRCPY-MCP · SCANNED AUG 3
MCP server for Android device control via ADB and scrcpy
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →
Supply Chain Security87
- No malware found by supply-chain analysis.Pass
- Only part of the dependency tree could be resolved (111 of 115), so this covers what we could see, not the whole tree.Partial
- No install/post-install scripts declared.Pass
- Only part of the dependency tree could be resolved (111 of 115), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency97
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to JuanCF/scrcpy-mcp). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 28 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability79
- AI-judged instruction clarity (excellent).Pass
- Tool/resource definitions use about 2179 tokens (~55/item across 39 items; 39 tools + 0 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
- Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · scrcpy-mcp
claude mcp add juancf-scrcpy-mcp -- npx -y scrcpy-mcp
codex mcp add juancf-scrcpy-mcp -- npx -y scrcpy-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"juancf-scrcpy-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"scrcpy-mcp"
],
"enabled": true
}
}
} openclaw mcp add juancf-scrcpy-mcp --command npx --arg -y --arg scrcpy-mcp
mcp_servers:
juancf-scrcpy-mcp:
command: "npx"
args: ["-y", "scrcpy-mcp"] {
"mcpServers": {
"juancf-scrcpy-mcp": {
"command": "npx",
"args": [
"-y",
"scrcpy-mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 3 Aug 26 +4
- Stability: unverified → 0.27 ▲ functional
- 2 Aug 26 +55
- Known CVEs: unverified → partial ▲ security
- Install scripts: unverified → pass ▲ security
- Provenance: unverified → pass ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- The attested source repository moved: JuanCF/scrcpy-mcp security
- Security disclosure: fail → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- Schema quality: unverified → excellent ▲ functional
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- First check of Schema quality: unverified functional
- Licence: MIT functional
- 1 Aug 26 −7
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 31 Jul 26 −18
- Malware scan: pass → unverified ▼ security
- 27 Jul 26 46
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Analysed npm/[email protected]
Provenance verified
Ecosystem: npm · Outcome: verified
Reason: verified
- Source repo:
- JuanCF/scrcpy-mcp
- Certificate issuer:
- https://token.actions.githubusercontent.com
- Certificate SAN:
- https://github.com/JuanCF/scrcpy-mcp/.github/workflows/publish.yml@refs/heads/main
- Rekor log index:
- 2083979478
- Predicate type:
- https://slsa.dev/provenance/v1
- Subject digest:
- sha512:6308cb8ecea42012e70ae0441b6ad2f052f9b5d4696755943ea56d562f885fd18dabe19f28cfc6acfc999616a0c03323384bed7648172653cbead9646
- Discovery method:
- attestation_endpoint
Dependencies 111 packages
111 packages in the resolved dependency tree · 102 deprecated · 40 stale.
The dependency tree was only partially resolved, so these counts may be incomplete.
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
app_current ~29
Get the currently foregrounded app package name and activity.
| Name | Type | Req | Description |
|---|---|---|---|
| serial | string | — | Device serial number |
| Name | Type | Req | Description |
|---|---|---|---|
| activity | — | yes | Foreground activity name, if resolvable |
| packageName | string | yes | Package name of the foreground app |
No examples provided.
app_install ~48
Install an APK file on the device from the host machine.
| Name | Type | Req | Description |
|---|---|---|---|
| apkPath | string | yes | Absolute path to the APK file on the host machine |
| serial | string | — | Device serial number |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Install result or error output from adb |
| success | boolean | yes | Whether the APK installed successfully |
No examples provided.
app_list ~79
List installed packages on the device. Optionally filter by name or restrict to system/third-party apps.
| Name | Type | Req | Description |
|---|---|---|---|
| filter | string | — | Filter packages by name (partial match, case-insensitive) |
| serial | string | — | Device serial number |
| system | boolean | — | true = system apps only, false = third-party only, omit = all |
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | yes | Number of packages returned |
| packages | array | yes | Installed package names |
No examples provided.
app_start ~99
Launch an app on the device. Uses scrcpy START_APP when a session is active for faster launch, falls back to ADB `am start`. Supports force-stop prefix (+) to stop the app before launching.
| Name | Type | Req | Description |
|---|---|---|---|
| packageName | string | yes | Package name to launch (e.g., 'com.example.app'). Prefix with '+' to force-stop the app first (e.g., '+com.example.app') |
| serial | string | — | Device serial number |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable description of the result |
| source | string | — | Mechanism used to launch the app (scrcpy or adb) |
| success | boolean | yes | Whether the app was launched |
No examples provided.
app_stop ~47
Force-stop an app on the device.
| Name | Type | Req | Description |
|---|---|---|---|
| packageName | string | yes | Package name to force-stop (e.g., 'com.example.app') |
| serial | string | — | Device serial number |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable description of the result |
| success | boolean | yes | Whether the app was force-stopped |
No examples provided.
app_uninstall ~47
Uninstall an app from the device.
| Name | Type | Req | Description |
|---|---|---|---|
| packageName | string | yes | Package name to uninstall (e.g., 'com.example.app') |
| serial | string | — | Device serial number |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Uninstall result or error output from adb |
| success | boolean | yes | Whether the app was uninstalled |
No examples provided.
clipboard_get ~55
Get the current clipboard content from the device. Uses scrcpy GET_CLIPBOARD when a session is active (works on Android 10+), falls back to ADB clipboard commands.
| Name | Type | Req | Description |
|---|---|---|---|
| serial | string | — | Device serial number |
| Name | Type | Req | Description |
|---|---|---|---|
| content | string | yes | Current clipboard text on the device |
| source | string | yes | Mechanism used to read the clipboard (scrcpy or adb) |
No examples provided.
clipboard_set ~80
Set the clipboard content on the device. Uses scrcpy SET_CLIPBOARD when a session is active (with optional paste flag), falls back to ADB clipboard commands.
| Name | Type | Req | Description |
|---|---|---|---|
| paste | boolean | — | Also simulate paste action (scrcpy only) |
| serial | string | — | Device serial number |
| text | string | yes | Text to set in the clipboard |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable description of the result |
| source | string | — | Mechanism used to set the clipboard (scrcpy or adb) |
| success | boolean | yes | Whether the clipboard was set |
No examples provided.
collapse_panels ~35
Collapse all open panels (notification, settings) (requires active scrcpy session)
| Name | Type | Req | Description |
|---|---|---|---|
| serial | string | — | Device serial number |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable description of the result |
| success | boolean | yes | Whether the action succeeded |
No examples provided.
connect_wifi ~55
Enable WiFi ADB and connect to the device wirelessly. Returns the connection address.
| Name | Type | Req | Description |
|---|---|---|---|
| port | integer | — | TCP port for ADB connection (default: 5555) |
| serial | string | — | Device serial number |
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | — | The host:port the device was connected on |
| message | string | yes | Human-readable description of the result |
| success | boolean | yes | Whether the wireless connection was established |
No examples provided.
device_info ~48
Get detailed info about a device: model, Android version, screen size, SDK level, battery level
| Name | Type | Req | Description |
|---|---|---|---|
| serial | string | — | Device serial number. If omitted, uses the only connected device. |
| Name | Type | Req | Description |
|---|---|---|---|
| androidVersion | — | yes | Android release version |
| batteryLevel | — | yes | Battery level percentage |
| brand | — | yes | Device brand |
| manufacturer | — | yes | Device manufacturer |
| model | — | yes | Device model |
| screenHeight | integer | yes | Screen height in pixels |
| screenWidth | integer | yes | Screen width in pixels |
| sdkLevel | — | yes | Android SDK API level |
| serial | string | yes | Resolved device serial |
No examples provided.
device_list ~23
List all connected Android devices with their serial numbers, state, and model
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | yes | Number of connected devices |
| devices | array | yes | Connected devices |
No examples provided.
disconnect_wifi ~40
Disconnect from a wireless ADB device
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | yes | Device address (e.g., 192.168.1.100:5555) |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable description of the result |
| success | boolean | yes | Whether the action succeeded |
No examples provided.
drag_drop ~109
Perform a drag and drop gesture from one point to another. Uses input draganddrop on Android 8.0+ (API 26), falls back to swipe on older versions.
| Name | Type | Req | Description |
|---|---|---|---|
| duration | integer | — | Duration in milliseconds |
| endX | integer | yes | End X coordinate |
| endY | integer | yes | End Y coordinate |
| serial | string | — | Device serial number |
| startX | integer | yes | Start X coordinate |
| startY | integer | yes | Start Y coordinate |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable description of the action performed |
| success | boolean | yes | Whether the input action was dispatched to the device |
No examples provided.
expand_notifications ~29
Expand the notification panel (requires active scrcpy session)
| Name | Type | Req | Description |
|---|---|---|---|
| serial | string | — | Device serial number |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable description of the result |
| success | boolean | yes | Whether the action succeeded |
No examples provided.
expand_settings ~30
Expand the quick settings panel (requires active scrcpy session)
| Name | Type | Req | Description |
|---|---|---|---|
| serial | string | — | Device serial number |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable description of the result |
| success | boolean | yes | Whether the action succeeded |
No examples provided.
file_list ~47
List directory contents on the device.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | Absolute path to the directory on the device (e.g., /sdcard/) |
| serial | string | — | Device serial number |
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | yes | Number of entries returned |
| entries | array | yes | Directory entries |
| path | string | yes | The directory that was listed |
No examples provided.
file_pull ~69
Pull a file from the device to the host machine.
| Name | Type | Req | Description |
|---|---|---|---|
| localPath | string | yes | Destination absolute path on the host machine |
| remotePath | string | yes | Path to the file on the device (e.g., /sdcard/myfile.txt) |
| serial | string | — | Device serial number |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | adb pull result or a confirmation message |
| success | boolean | yes | Whether the file was pulled |
No examples provided.
file_push ~69
Push a file from the host machine to the device.
| Name | Type | Req | Description |
|---|---|---|---|
| localPath | string | yes | Absolute path to the file on the host machine |
| remotePath | string | yes | Destination path on the device (e.g., /sdcard/myfile.txt) |
| serial | string | — | Device serial number |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | adb push result or a confirmation message |
| success | boolean | yes | Whether the file was pushed |
No examples provided.
input_text ~37
Type text into the currently focused input field
| Name | Type | Req | Description |
|---|---|---|---|
| serial | string | — | Device serial number |
| text | string | yes | Text to type |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable description of the action performed |
| success | boolean | yes | Whether the input action was dispatched to the device |
No examples provided.
key_event ~64
Send a key event to the device. Supports keycodes like HOME, BACK, ENTER, VOLUME_UP, etc.
| Name | Type | Req | Description |
|---|---|---|---|
| keycode | — | yes | Keycode name (e.g., 'HOME', 'BACK') or numeric value |
| serial | string | — | Device serial number |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable description of the action performed |
| success | boolean | yes | Whether the input action was dispatched to the device |
No examples provided.
long_press ~55
Perform a long press at the specified coordinates
| Name | Type | Req | Description |
|---|---|---|---|
| duration | integer | — | Duration in milliseconds |
| serial | string | — | Device serial number |
| x | integer | yes | X coordinate |
| y | integer | yes | Y coordinate |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable description of the action performed |
| success | boolean | yes | Whether the input action was dispatched to the device |
No examples provided.
rotate_device ~29
Rotate the device screen (requires active scrcpy session)
| Name | Type | Req | Description |
|---|---|---|---|
| serial | string | — | Device serial number |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable description of the result |
| success | boolean | yes | Whether the action succeeded |
No examples provided.
screen_off ~24
Turn the device screen off
| Name | Type | Req | Description |
|---|---|---|---|
| serial | string | — | Device serial number |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable description of the result |
| success | boolean | yes | Whether the action succeeded |
No examples provided.
screen_on ~27
Wake the device screen (turn screen on)
| Name | Type | Req | Description |
|---|---|---|---|
| serial | string | — | Device serial number |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable description of the result |
| success | boolean | yes | Whether the action succeeded |
No examples provided.
screen_record_start ~68
Start recording the screen. Recording continues until screen_record_stop is called.
| Name | Type | Req | Description |
|---|---|---|---|
| duration | number | — | Max recording duration in seconds (optional, device limit usually 180s) |
| remotePath | string | — | Path on device to save recording |
| serial | string | — | Device serial number |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable status message |
| remotePath | string | — | Path on the device where the recording is saved |
| success | boolean | yes | Whether recording was started |
No examples provided.
screen_record_stop ~68
Stop screen recording and optionally pull the file to the host.
| Name | Type | Req | Description |
|---|---|---|---|
| localPath | string | — | Local path to save recording (only if pullToHost is true) |
| pullToHost | boolean | — | Pull the recording to the host machine |
| serial | string | — | Device serial number |
| Name | Type | Req | Description |
|---|---|---|---|
| localPath | string | — | Host path the recording was pulled to, if requested |
| message | string | yes | Human-readable status message |
| success | boolean | yes | Whether recording was stopped |
No examples provided.
screenshot ~33
Take a screenshot of the Android device screen. Returns the image as base64.
| Name | Type | Req | Description |
|---|---|---|---|
| serial | string | — | Device serial number |
| Name | Type | Req | Description |
|---|---|---|---|
| encoding | string | yes | Encoding of the image data in the content block |
| mimeType | string | yes | MIME type of the returned image |
| source | string | yes | Capture path used (scrcpy frame or adb screencap) |
No examples provided.
scroll ~101
Scroll at the specified position. dx and dy are scroll amounts (-1 to 1 range approximated for ADB).
| Name | Type | Req | Description |
|---|---|---|---|
| dx | number | yes | Horizontal scroll amount (negative=left, positive=right) |
| dy | number | yes | Vertical scroll amount (negative=up, positive=down) |
| serial | string | — | Device serial number |
| x | integer | yes | X coordinate to scroll at |
| y | integer | yes | Y coordinate to scroll at |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable description of the action performed |
| success | boolean | yes | Whether the input action was dispatched to the device |
No examples provided.
shell_exec ~59
Execute an arbitrary ADB shell command on the device and return the output. Use this for any device operation not covered by other tools.
| Name | Type | Req | Description |
|---|---|---|---|
| command | string | yes | Shell command to execute on the device |
| serial | string | — | Device serial number |
| Name | Type | Req | Description |
|---|---|---|---|
| output | string | yes | Combined stdout/stderr text from the command |
No examples provided.
start_session ~93
Start a scrcpy session for fast input control and screenshots. When a session is active, tap/swipe/text/screenshot are 10-50x faster. Requires scrcpy-server to be installed.
| Name | Type | Req | Description |
|---|---|---|---|
| maxFps | integer | — | Max frames per second (default 30) |
| maxSize | integer | — | Max screen dimension in pixels (default 1024) |
| serial | string | — | Device serial number |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable status message |
| screenSize | object | yes | Native display resolution — tap/swipe use these native coordinates, matching ui_dump / ui_find_element bounds directly (no scaling) |
| serial | string | yes | Resolved device serial |
| status | string | yes | Session status (e.g. 'connected') |
| videoAvailable | boolean | yes | Whether the scrcpy video stream is up. When false, the session still works for input/clipboard but screenshots fall back to adb screencap. |
No examples provided.
start_video_stream ~67
Start an HTTP MJPEG video stream of the device screen and open a viewer window (ffplay). Starts a scrcpy session automatically if needed.
| Name | Type | Req | Description |
|---|---|---|---|
| port | integer | — | HTTP port for the MJPEG stream (default 7183) |
| serial | string | — | Device serial number |
| Name | Type | Req | Description |
|---|---|---|---|
| screenSize | object | yes | Native display resolution — tap/swipe use these native coordinates (no scaling) |
| status | string | yes | Stream status (e.g. 'started') |
| url | string | yes | HTTP URL of the MJPEG stream |
| viewer | string | yes | Viewer status message |
No examples provided.
stop_session ~34
Stop the active scrcpy session. Tools will fall back to ADB commands.
| Name | Type | Req | Description |
|---|---|---|---|
| serial | string | — | Device serial number |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable status message |
| success | boolean | yes | Whether the session was stopped |
No examples provided.
stop_video_stream ~35
Stop the HTTP MJPEG video stream and close the viewer window for a device.
| Name | Type | Req | Description |
|---|---|---|---|
| serial | string | — | Device serial number |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable status message |
| status | string | yes | Stream status (e.g. 'stopped') |
No examples provided.
swipe ~81
Perform a swipe gesture from one point to another
| Name | Type | Req | Description |
|---|---|---|---|
| duration | integer | — | Duration in milliseconds |
| serial | string | — | Device serial number |
| x1 | integer | yes | Start X coordinate |
| x2 | integer | yes | End X coordinate |
| y1 | integer | yes | Start Y coordinate |
| y2 | integer | yes | End Y coordinate |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable description of the action performed |
| success | boolean | yes | Whether the input action was dispatched to the device |
No examples provided.
tap ~42
Tap at the specified screen coordinates
| Name | Type | Req | Description |
|---|---|---|---|
| serial | string | — | Device serial number |
| x | integer | yes | X coordinate |
| y | integer | yes | Y coordinate |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable description of the action performed |
| success | boolean | yes | Whether the input action was dispatched to the device |
No examples provided.
ui_dump ~41
Dump the full UI hierarchy of the current screen as XML. Useful for understanding screen structure before using ui_find_element.
| Name | Type | Req | Description |
|---|---|---|---|
| serial | string | — | Device serial number |
| Name | Type | Req | Description |
|---|---|---|---|
| xml | string | yes | The UI hierarchy as a uiautomator XML document |
No examples provided.
ui_find_element ~136
Find UI elements on screen by text, resource ID, class name, or content description. Returns matching elements with their tap coordinates. At least one search criterion must be provided.
| Name | Type | Req | Description |
|---|---|---|---|
| className | string | — | Class name to match exactly (e.g., 'android.widget.Button') |
| contentDesc | string | — | Content description to search for (partial match, case-insensitive) |
| resourceId | string | — | Resource ID to match exactly (e.g., 'com.app:id/button') |
| serial | string | — | Device serial number |
| text | string | — | Text content to search for (partial match, case-insensitive) |
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | yes | Number of matching elements |
| elements | array | yes | Matching UI elements with tap coordinates |
No examples provided.
version ~47
Report which scrcpy version is being used by the MCP server. The version is detected from the SCRCPY_SERVER_VERSION environment variable, the scrcpy --version binary, or a built-in default.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| source | string | yes | Where the version was resolved from: 'env' (SCRCPY_SERVER_VERSION env var), 'binary' (scrcpy --version), or 'default' (built-in constant) |
| version | string | yes | Scrcpy version string (e.g. '4.0', '2.7') |
No examples provided.