# AScript Cursor 本地 MCP 配置

Cursor 不能直接安装 Codex 插件，但可以复用 AScript MCP 工具和 AI Studio 工作流的本地直连适配版规则。手机通过本地局域网或 Android USB/ADB 连接，不使用 AI Studio 服务器配对链路。

## 前置要求

先安装 `uv`，让 `uvx` 可用：

macOS / Linux：

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

Windows PowerShell：

```powershell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```

## 1. MCP 配置

把 `cursor-mcp.json` 保存到项目根目录：

```text
.cursor/mcp.json
```

配置内容：

```json
{
  "mcpServers": {
    "ascript-local": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--with", "mcp<2", "ascript-mcp==1.7.0"]
    }
  }
}
```

## 2. Rules 配置

把 `cursor-rules.mdc` 保存到：

```text
.cursor/rules/ascript.mdc
```

## 3. 验证

打开 Cursor 的 **Customize -> MCP**，确认 `ascript-local` 已连接。然后切换到 Agent 模式，让 Cursor 先观察设备，再写 AScript 代码并运行验证。

## 4. 连接手机

安装 MCP 不会自动连接手机。请在手机安装并打开 AScript App，在 **开发者** 中开启设备服务。

局域网方式：让手机和电脑连接同一个 Wi-Fi，在 Cursor Agent 中输入：

```text
请先扫描局域网 AScript 设备；找到设备后先告诉我设备名称、平台和 IP，等我确认后再连接。
```

确认后由 Cursor 调用 `connect_device` 连接，默认端口为 `9096`。

Android USB 方式：打开 USB 调试、确认 ADB 授权，并确保 `adb devices` 显示设备为 `device`，然后输入：

```text
请扫描 USB/ADB 设备，连接我确认的 Android 设备，然后读取设备状态和当前屏幕。
```

连接后用 `get_device_status` 或 `screen_capture` 验证。MCP 显示已连接不等于手机已连接。

注意：AI Studio 的配对码只用于服务器中转链路。本地 `uvx ascript-mcp==1.7.0` 不支持读取该配对码；本地 Cursor 需要使用局域网或 Android USB/ADB 连接。不要把手机 `9096` 暴露到公网。

## 5. 注意

这里不使用线上 MCP。线上 MCP 只适合文档查询，不能连接本地手机、上传工程、运行脚本或读取日志。