Ascript MCP server

by ascript-cn·io.github.ascript-cn/ascript-mcp·v1.7.0·9 stars

No reviews yet

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

B80/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B80/100

full report

Adoption

New

9 stars

Reviews

Write one

Nobody has reviewed Ascript yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Ascript tools (7, 2 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

create_projectwrite action
在设备上创建新工程。上传文件前需要先创建工程。
get_code_example
获取常见自动化任务的可运行代码示例。
get_project_files
获取设备上指定工程的文件树结构。
get_setup_guide
获取指定平台的环境搭建和安装指南。
list_projects
列出设备上的所有工程。
run_projectwrite action
在设备上运行指定工程。
stop_project
停止设备上正在运行的工程。

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings

Code scan11 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitylocal package, no credentials required12/15
Maintenancelast push 151 days ago8/15
Maintainer identityregistry namespace matches repository owner7/10

Overall 80/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Ascript compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 80/100; higher than 60% of 48,255 servers
Tools: 7; the typical server has 7
Tools that change things: 29%; typical: 0%. Fewer write tools means less an agent can break
GitHub stars: 9; more than 87% of 28,688 servers

What its tools let an agent do: 4 read · 1 create · 2 run or deploy

Install Ascript in Claude Code, Cursor or VS Code

claude mcp add ascript-mcp -- uvx ascript-mcp

Add to Cursor

What the publisher says

From the Ascript repository's README, as published. We do not edit it. Read it on GitHub

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. 规则配置

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

这份规则模板包含：

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

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

当用户需要编写设备自动化脚本（Android/iOS/Windows）时，必须先调用 ascript MCP 的

getdevicestatus 与 listpythonpackages，再用 eval_python 在设备 REPL 里

验证关键代码片段，最后才 uploadfile + runproject。

禁止凭记忆编写 ascript 代码。

工具列表

API 文档（5 个）

在线插件（2 个）

设备连接（5 个）

观察界面（6 个）

开发部署（7 个）

文件管理（2 个）

线上 SSE 模式

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

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

License

Ascript: common questions

Is Ascript MCP server safe?: Mostly: it is graded B (80/100). Read the Ascript safety report
How do I install Ascript?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Ascript need an API key?: Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Ascript maintained?: The last commit was 188 days ago (2026-04-30). The latest release is v1.7.0.
What can I use instead of Ascript?: Servers from other publishers that do the same job: MCP Appium - Mobile Development and Automation Server MCP server, Mobilerun MCP server and Mobile MCP server.
How does Ascript compare with other MCP servers?: safety score 80/100 (higher than 60% of 48,255 servers); tools 7 (the typical server has 7); tools that change things 29% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Ascript

Same job from other publishers: the closest match first, then the best rated.

MCP Appium - Mobile Development and Automation Server
MCP server for Appium mobile automation on iOS and Android devices with test creation tools.
not reviewed
Established
A
Mobilerun
Let AI agents control Android and iOS devices on Mobilerun Cloud: screen, input, apps, workflows.
not reviewed
Established
A
Mobile
MCP server for iOS and Android Mobile Development, Automation and Testing
not reviewed
Widely used
A