推荐本地部署，让 AI 真正接管自动化开发
本地 MCP 安装在你的电脑上，可以连接 Android / iOS 手机，让 AI 先观察设备，再编写、上传、运行脚本并读取日志。在线 MCP 只适合查询文档，不具备手机控制能力。
本地 MCP
安装 Python
先安装 Python 3.10+，并确认终端可以执行 python 命令。 下载 Python
安装 ascript-mcp
在终端执行 pip 安装命令。
pip install ascript-mcp
配置本地服务
把 本地 MCP 服务配置到 Cursor、Trae、Claude Desktop 等 AI 工具中。
{
"mcpServers": {
"ascript": {
"command": "python",
"args": ["-m", "ascript_mcp.local"]
}
}
}适合 python 命令已经指向目标解释器的环境。
配置 AGENT_RULES.md
下载规则模板并放到工程规则中，让 AI 按“先观察、再验证、再运行”的方式调用 MCP。 下载 AGENT_RULES.md
四步完成本地部署
安装 Python
安装 Python 3.10+，并把 Python 加入系统 PATH，确保终端可以正常执行 python。
安装 ascript-mcp
通过 pip install ascript-mcp 安装本地 MCP 服务，它负责把设备能力暴露给 AI 工具。
配置本地 MCP 服务
在 AI 工具中加入 python -m ascript_mcp.local 配置，然后让 AI 先连接设备、观察界面，再生成脚本。
配置 AGENT_RULES.md
把 AGENT_RULES.md 配置到项目规则中，约束 AI 使用 MCP 工具完成观察、验证、上传运行和日志迭代。
本地 MCP 与在线 MCP 的区别
在线 MCP 只作为文档查询入口
在线 MCP 不会连接你的电脑和手机，也不能上传、运行或调试本地工程。它只适合让 AI 查询 AScript API、代码示例和插件信息。
{
"mcpServers": {
"ascript": {
"url": "https://mcp.ascript.cn/sse"
}
}
}地址必须使用 https://mcp.ascript.cn/sse。根路径或 /see 会返回 404。
本地部署后的核心能力
观察设备
截图、OCR、控件树、颜色识别与选择器测试，让 AI 看见真实界面。
运行脚本
创建工程、上传文件、运行或停止脚本，并持续读取运行日志。
查询文档
检索 Android、iOS、Windows API 文档、示例代码和环境指南。
查询插件
查询 OCR、YOLO、HID、大模型等 AScript 在线插件能力。
遵循规则
配合 AGENT_RULES.md，让 AI 按标准流程调用 MCP，不跳过观察与验证。