ascript-mcp
中文 | English
AScript MCP Service — 让 AI 编程工具（Claude Desktop / Cursor / Trae）直接查询 AScript API 文档、操控真实 Android / iOS 设备（iOS 免签免越狱）。
功能
- API 文档查询：模块概览、API 搜索、代码示例、环境搭建指南
- 在线插件查询：实时查询 AScript 插件库（OCR、YOLO、HID、大模型等）
- 设备交互：截图、控件树、OCR、找色、比色、选择器测试
- 开发部署：创建工程、上传代码、运行、停止、查看日志
- 设备管理：局域网扫描、ADB 扫描、自动连接
安装
pip install ascript-mcp
配置 Cursor
1. MCP 配置
在项目根目录创建 .cursor/mcp.json：
{
"mcpServers": {
"ascript": {
"command": "python",
"args": ["-m", "ascript_mcp.local"]
}
}
}
2. 规则配置
在项目根目录创建 .cursorrules 文件：
当用户需要编写设备自动化脚本（Android/iOS/Windows）时，必须使用 ascript MCP 工具连接设备、观察界面、查询 API 后再编写代码，禁止凭记忆编写 ascript 代码。
工具列表
API 文档（5 个）
| 工具 | 说明 |
|---|---|
get_platform_overview |
获取平台 API 模块概览 |
get_module_apis |
获取模块详细 API 文档 |
search_api |
按关键词搜索 API |
get_code_example |
获取代码示例 |
get_setup_guide |
获取环境搭建指南 |
在线插件（2 个）
| 工具 | 说明 |
|---|---|
list_plugins |
查询插件库列表 |
get_plugin_detail |
获取插件详细文档 |
设备连接（3 个）
| 工具 | 说明 |
|---|---|
auto_connect |
从工程配置自动连接设备 |
scan_devices |
扫描局域网 + ADB 设备 |
connect_device |
手动连接指定设备 |
观察界面（6 个）
| 工具 | 说明 |
|---|---|
screen_capture |
截取设备屏幕 |
dump_ui_tree |
获取控件树 |
test_selector |
测试选择器是否匹配 |
ocr |
屏幕文字识别 |
find_colors |
多点找色 |
compare_colors |
多点比色 |
开发部署（5 个）
| 工具 | 说明 |
|---|---|
create_project |
在设备上创建工程 |
upload_file |
上传文件到设备（自动创建工程） |
run_project |
运行工程 |
stop_project |
停止运行 |
get_run_log |
获取运行日志 |
文件管理（2 个）
| 工具 | 说明 |
|---|---|
list_projects |
列出设备上的工程 |
get_project_files |
获取工程文件树 |
线上 SSE 模式
如需部署为公网服务（仅 API 文档查询）：
uvicorn ascript_mcp.server:app --host 0.0.0.0 --port 8000
License
MIT License，详见 LICENSE。Copyright © 2026 北京奥悦科技有限公司。
更多信息
- AScript 官网：https://ascript.cn
- API 文档：https://docs.airscript.cn
- 插件库：https://py.airscript.cn
- 社区论坛：https://bbs.ascript.cn
- 京ICP备 2020040944号-4
