How do I install Ascript?

Ascript is a local plugin. Install it using PyPI package: ascript-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What AI apps work with Ascript?

Ascript uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Ascript MCP Server

by Ascript Cn

Developer ToolsUse Caution3.2MCP RegistryLocal

Free

Server data from the Official MCP Registry

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

About

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

Security Report

3.2

Use Caution3.2High Risk

This MCP server provides device automation and API documentation access for AScript (Android/iOS automation framework). While the authentication model is reasonable and permissions align with its purpose, there are moderate security concerns: subprocess execution for ADB without validation, unencrypted HTTP-only communication with devices, potential exposure of device credentials in error messages, and missing input validation on several user-facing functions. The code quality is generally acceptable but has gaps in error handling and logging discipline. Supply chain analysis found 8 known vulnerabilities in dependencies (0 critical, 7 high severity). Package verification found 1 issue.

4 files analyzed · 20 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

Shell Command Execution

Runs commands on your machine. Be cautious — only use if you trust this plugin.

process_spawn

Check that this permission is expected for this type of plugin.

Unverified package source

We couldn't verify that the installable package matches the reviewed source code. Proceed with caution.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-ascript-cn-ascript-mcp": {
      "args": [
        "ascript-mcp"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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 的
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 文档查询）：

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

License

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

Ascript MCP Server

About

Security Report

Findings (20)Action required

Permissions Required

How to Install

Documentation

ascript-mcp

功能

安装

配置 Cursor

1. MCP 配置

2. 规则配置

工具列表

API 文档（5 个）

在线插件（2 个）

设备连接（5 个）

观察界面（6 个）

开发部署（7 个）

文件管理（2 个）

线上 SSE 模式

License

更多信息

Reviews

No reviews yet

More Developer Tools MCP Servers

Git

Fetch

Toleno

mcp-creator-python

MarkItDown

FinAgent