Ascript Mcp

io.github.ascript-cnPublished by GitHub account ascript-cnv1.7.0Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyBrowser AutomationDeveloper Tools

Overview

AI-generated overview

Lets an AI assistant query AScript API docs and control real Android, iOS, or Windows devices for automation scripting.

What you can do
Provides tools to look up AScript platform API modules, search APIs, fetch code examples, setup guides, and plugin documentation. It also connects to devices over LAN or ADB, captures screens, dumps UI trees, runs OCR and color matching, and manages projects by creating, uploading, running, stopping, and reading logs. A device-side Python REPL tool executes code directly for exploration and custom workflows.
When to use it
Use it when writing or debugging AScript device automation scripts for Android, iOS, or Windows, especially when you want the assistant to inspect a live device, verify snippets before running them, or deploy and run projects. It is aimed at automation tasks such as login flows, check-ins, or game interactions.
Requirements
Runs locally as a Python package installed with pip or uvx. Requires a reachable Android, iOS, or Windows device with the AScript app, plus LAN or ADB connectivity for device tools. The README also describes an optional SSE mode for public API-doc-only deployment.
Before you install
Device tools can capture screens, read UI content, run arbitrary Python on the device, upload files, and start or stop projects, so they act on real devices and can change or delete data. The README recommends copying agent rules that forbid writing AScript code from memory. Review what is uploaded and executed before running it.

Installation

In SourceWeft

  1. Open Ascript Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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 北京奥悦科技有限公司。

更多信息

Source: README.md at commit d945089

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.7.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts