Ascript Mcp

io.github.ascript-cn由 GitHub 帳號 ascript-cn 發布v1.7.0更新於 Oct 24, 2026

Control Android/iOS/Windows devices from Claude, Cursor, and other AI tools. iOS without jailbreak.

已驗證STDIO僅桌面瀏覽器自動化開發者工具

概覽

AI 產生的概覽

讓 AI 助理查詢 AScript API 文件並控制真實 Android、iOS 或 Windows 裝置以撰寫自動化腳本。

可以做什麼
提供查詢 AScript 平台 API 模組、搜尋 API、取得程式碼範例、環境建置指南與外掛文件等工具。也能透過區域網路或 ADB 連接裝置，擷取畫面、取得控制項樹、執行 OCR 與找色比色，並管理專案：建立、上傳、執行、停止與查看日誌。裝置端 Python REPL 工具可直接執行程式碼，用於探索除錯與自訂工作流程。
適用情境
適合撰寫或除錯 Android、iOS、Windows 的 AScript 裝置自動化腳本時使用，尤其是希望助理檢查真實裝置、在執行前驗證程式碼片段，或部署並執行專案。面向登入、簽到、遊戲互動等自動化任務。
執行需求
以 Python 套件形式在本機執行，可用 pip 或 uvx 安裝。需要可連線的 Android、iOS 或 Windows 裝置並安裝 AScript 應用程式，裝置工具還需區域網路或 ADB 連線。README 另述可選的 SSE 模式，僅用於公網 API 文件查詢。
安裝前請注意
裝置工具可擷取畫面、讀取介面內容、在裝置上執行任意 Python、上傳檔案以及啟動或停止專案，會作用於真實裝置並可能變更或刪除資料。README 建議複製禁止憑記憶撰寫 AScript 程式碼的代理規則。執行前請確認上傳與執行的內容。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Ascript Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

ascript-mcp

中文 | English

[PyPI] [License: MIT] [Python]

AScript MCP Service — 让 AI 编程工具（Claude Desktop / Cursor / Trae）直接查询 AScript API 文档、操控真实 Android / iOS 设备（iOS 免签免越狱）。

功能

  • API 文档查询：模块概览、API 搜索、代码示例、环境搭建指南
  • 在线插件查询：实时查询 AScript 插件库（OCR、YOLO、HID、大模型等）
  • 设备交互：截图、控件树、OCR、找色、比色、选择器测试
  • 开发部署：创建工程、上传代码、运行、停止、查看日志
  • 设备管理：局域网扫描、ADB 扫描、自动连接

安装

bash
pip install ascript-mcp

配置 Cursor

1. MCP 配置

在项目根目录创建 .cursor/mcp.json：

json
{  "mcpServers": {    "ascript": {      "command": "python",      "args": ["-m", "ascript_mcp.local"]    }  }}

2. 规则配置

把 docs/AGENT_RULES.md 完整复制到你的自动化工程根目录的 .cursorrules（Cursor）或 CLAUDE.md / AGENTS.md（Claude Code / 其他 IDE）。

这份规则模板包含：

  • 5 阶段标准工作流（先观察 → 选策略 → eval_python 迭代 → 必要时裁图 → 上传运行）
  • 选 API 的决策树（控件 → OCR → 找图 → 找色）
  • 自动登录 / 签到 / 游戏战斗等常见任务的编排范例
  • 反模式清单（凭空猜代码、不验证就 run、硬编码不存在的图片路径等）

简版规则（仅当你不想复制完整规则时用）：

当用户需要编写设备自动化脚本（Android/iOS/Windows）时，必须先调用 ascript MCP 的get_device_status 与 list_python_packages，再用 eval_python 在设备 REPL 里验证关键代码片段，最后才 upload_file + run_project。禁止凭记忆编写 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获取插件详细文档

设备连接（5 个）

工具说明
auto_connect从工程配置自动连接设备
scan_devices扫描局域网 + ADB 设备
connect_device手动连接指定设备
get_device_status获取设备完整运行状态（运行模式/权限/屏幕/电池/内存/正在跑的脚本等，仅 Android）
list_python_packages列出设备 AScript App 已安装的 Python 第三方库（Android + iOS）

观察界面（6 个）

工具说明
screen_capture截取设备屏幕
dump_ui_tree获取控件树
test_selector测试选择器是否匹配
ocr屏幕文字识别
find_colors多点找色
compare_colors多点比色

开发部署（7 个）

工具说明
create_project在设备上创建工程
upload_file上传文件到设备（自动创建工程）
run_project运行工程
run_project_debug调试模式运行（Android + ADB），自动 forward 5678 端口并返回 VS Code attach 配置
stop_project停止运行
get_run_log获取运行日志
eval_python设备 Python REPL（Android + iOS）：直接在主进程 exec 代码立即拿结果，几百毫秒一轮。适合探索调试、复合决策、自定义工作流（SoM/智能 tap/自动裁模板等）。iOS 自动转译 ascript.android.* → ascript.ios.* 并预加载 cv2/np/Image。详见 AGENT_EVAL_GUIDE

文件管理（2 个）

工具说明
list_projects列出设备上的工程
get_project_files获取工程文件树

线上 SSE 模式

如需部署为公网服务（仅 API 文档查询）：

bash
uvicorn ascript_mcp.server:app --host 0.0.0.0 --port 8000

License

MIT License，详见 LICENSE。Copyright © 2026 北京奥悦科技有限公司。

更多信息

來源：README.md，提交 d945089

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.7.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分