# 安装 io.github.JuanCF/scrcpy-mcp

- 类型: MCP 工具
- 说明: 通过 ADB 与 scrcpy 远程控制安卓设备，便于调试、测试与自动化操作。
- 仓库: https://github.com/JuanCF/scrcpy-mcp
- ⚠ 安全: 该 MCP 工具主要通过本机 ADB 与 scrcpy 控制已连接的 Android 设备，未声明任何远程端点，整体未见明显高风险外发迹象。其主要安全关注点在于本机进程执行与对设备的操作能力；来源为官方 Registry 且开源，降低了整体风险，但文档较少、社区采用有限，仍建议在受限环境中使用。

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "io.github.JuanCF/scrcpy-mcp" MCP 服务：
执行：claude mcp add io-github-juancf-scrcpy-mcp -- npx -y scrcpy-mcp
```

### Codex
```
请帮我安装 askskill 上的 "io.github.JuanCF/scrcpy-mcp" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-github-juancf-scrcpy-mcp]
command = "npx"
args = ["-y","scrcpy-mcp"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "io.github.JuanCF/scrcpy-mcp" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-github-juancf-scrcpy-mcp": { "command": "npx", "args": ["-y","scrcpy-mcp"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --env ANDROID_SERIAL=YOUR_VALUE --env ADB_PATH=YOUR_VALUE --env SCRCPY_SERVER_PATH=YOUR_VALUE --transport stdio io-github-juancf-scrcpy-mcp -- npx -y scrcpy-mcp
```
需要环境变量：ANDROID_SERIAL, ADB_PATH, SCRCPY_SERVER_PATH

### Codex
```bash
codex mcp add --env ANDROID_SERIAL=YOUR_VALUE --env ADB_PATH=YOUR_VALUE --env SCRCPY_SERVER_PATH=YOUR_VALUE io-github-juancf-scrcpy-mcp -- npx -y scrcpy-mcp
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-juancf-scrcpy-mcp]
command = "npx"
args = ["-y","scrcpy-mcp"]

[mcp_servers.io-github-juancf-scrcpy-mcp.env]
ANDROID_SERIAL = "YOUR_VALUE"
ADB_PATH = "YOUR_VALUE"
SCRCPY_SERVER_PATH = "YOUR_VALUE"
```
需要环境变量：ANDROID_SERIAL, ADB_PATH, SCRCPY_SERVER_PATH

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-juancf-scrcpy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "scrcpy-mcp"
      ],
      "env": {
        "ANDROID_SERIAL": "YOUR_VALUE",
        "ADB_PATH": "YOUR_VALUE",
        "SCRCPY_SERVER_PATH": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-juancf-scrcpy-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsInNjcmNweS1tY3AiXSwiZW52Ijp7IkFORFJPSURfU0VSSUFMIjoiWU9VUl9WQUxVRSIsIkFEQl9QQVRIIjoiWU9VUl9WQUxVRSIsIlNDUkNQWV9TRVJWRVJfUEFUSCI6IllPVVJfVkFMVUUifX0
需要环境变量：ANDROID_SERIAL, ADB_PATH, SCRCPY_SERVER_PATH