跳到主要内容

Cursor 配置

Cursor 不能直接安装 Codex 插件，但可以复用同一套核心能力：本地 uvx --with 'mcp<2' ascript-mcp==1.7.0 MCP 服务，加上 AI Studio 工作流的本地直连适配版 Cursor Rules。

提示

这不是公开线上 MCP。AI Studio 服务器内的 MCP 通过配对链路访问手机；Cursor 中的本地 MCP 则通过局域网或 Android USB/ADB 直连手机。

本地适配配置包含什么​

文件作用
cursor/.cursor/mcp.jsonCursor 本地 MCP 配置，固定使用 ascript-mcp 1.7.0 和兼容的 MCP SDK
cursor/.cursor/rules/ascript.mdcAI Studio 工作流的本地直连适配版 Cursor 规则
plugins/ascript/skills/ascript/SKILL.mdCodex 原始 Skill，可作为规则来源参考

1. 下载配置包​

2. 添加 Cursor MCP​

把配置包里的文件复制到项目根目录：

.cursor/mcp.json

配置内容：

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

请先安装 uv，再确认终端能执行：

macOS / Linux：

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

Windows PowerShell：

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

3. 添加 Cursor Rules​

把配置包里的规则复制到：

.cursor/rules/ascript.mdc

这份规则复用了 AI Studio 服务器 Codex Skill 的核心工作流，并将设备连接步骤适配为本地直连：先查 API、再观察设备、再验证关键片段、上传运行、读取日志并迭代。

4. 连接手机并控制真机​

安装 MCP 和 Rules 不会自动连接手机。第一次使用前，需要先让本机 MCP 能访问手机上的 AScript App。

方式 A：局域网连接（Android / iOS）​

  1. 在手机安装并打开 AScript App，进入 开发者，开启设备服务，并记下显示的局域网 IP。

  2. 让手机和运行 Cursor 的电脑连接同一个 Wi-Fi。

  3. 在 Cursor Agent 中输入：

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

  4. 确认设备后，让 Cursor 调用 connect_device 连接。局域网默认端口是 9096。

方式 B：USB 连接（Android）​

  1. 打开 Android 开发者选项和 USB 调试，用 USB 线连接电脑，并在手机上确认 ADB 授权。

  2. 确认电脑可以执行 adb devices，状态应为 device。

  3. 在 Cursor Agent 中输入：

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

连接后，让 Cursor 调用 get_device_status 或 screen_capture 验证。只有返回真实设备状态或截图，才表示手机已经连通；仅看到 MCP 已连接不代表手机已连接。

AI Studio 配对码不是本地连接方式

AI Studio 服务器中的手机是通过配对码主动连接服务器，再由服务器转发给服务器内的 Codex。当前下载的本地 uvx ascript-mcp==1.7.0 不读取 AI Studio 配对码，也不能直接控制已经在 AI Studio 中配对的手机。本地 Cursor 必须使用上面的局域网直连或 Android USB/ADB；不要把手机 9096 暴露到公网。

5. 开始使用​

切换到 Agent 模式，输入需求：

检查当前手机界面，写一个能点击确认按钮的 AScript 脚本，并运行验证。

常见问题​

为什么不写 pip install ascript-mcp​

uvx --with 'mcp<2' ascript-mcp==1.7.0 会自动准备兼容依赖并在本机启动 AScript MCP，用户不需要先管理 Python 虚拟环境。AI Studio 服务器使用专用的本地进程和配对中转配置，不是这份本地直连配置。

能不能使用线上 MCP​

不能用于真机调试。线上 MCP 只适合查询 AScript API 文档和插件信息，不能连接你的手机、上传工程、运行脚本或读取日志。