Claude MarketplacesSubmit
ascript-cn avatar

Ascript Mcp

ascript-cn/ascript-mcp

Bridges Claude and friends directly to Android, iOS, and Windows devices through the AScript automation framework. You get API docs lookup, live device scanning and connection, screenshot and UI tree dumps, OCR and color matching, plus the ability to create projects, upload scripts, and run them remotely. The standout is eval_python, which gives you a sub-second REPL on the device itself for iterative testing before you commit to uploading full scripts. iOS support works without jailbreaking. Reach for this when you're building device automation workflows and want the LLM to query capabilities, inspect live UI state, prototype code snippets against real hardware, then deploy and monitor execution all without leaving the chat.

GitHub stars
7
tools
27
transport
STDIO
last updated
Apr 30, 2026
View on GitHub

Tools

27 tools

Public tool metadata for what this MCP can expose to an agent.

get_platform_overview获取平台 API 模块概览

获取平台 API 模块概览

No parameter schema in public metadata yet.

get_module_apis获取模块详细 API 文档

获取模块详细 API 文档

No parameter schema in public metadata yet.

search_api按关键词搜索 API

按关键词搜索 API

No parameter schema in public metadata yet.

get_code_example获取代码示例

获取代码示例

No parameter schema in public metadata yet.

get_setup_guide获取环境搭建指南

获取环境搭建指南

No parameter schema in public metadata yet.

list_plugins查询插件库列表

查询插件库列表

No parameter schema in public metadata yet.

get_plugin_detail获取插件详细文档

获取插件详细文档

No parameter schema in public metadata yet.

auto_connect从工程配置自动连接设备

从工程配置自动连接设备

No parameter schema in public metadata yet.

scan_devices扫描局域网 + ADB 设备

扫描局域网 + ADB 设备

No parameter schema in public metadata yet.

connect_device手动连接指定设备

手动连接指定设备

No parameter schema in public metadata yet.

get_device_status获取设备完整运行状态（运行模式/权限/屏幕/电池/内存/正在跑的脚本等，仅 Android）

获取设备完整运行状态（运行模式/权限/屏幕/电池/内存/正在跑的脚本等，仅 Android）

No parameter schema in public metadata yet.

list_python_packages列出设备 AScript App 已安装的 Python 第三方库（Android + iOS）

列出设备 AScript App 已安装的 Python 第三方库（Android + iOS）

No parameter schema in public metadata yet.

screen_capture截取设备屏幕

截取设备屏幕

No parameter schema in public metadata yet.

dump_ui_tree获取控件树

获取控件树

No parameter schema in public metadata yet.

test_selector测试选择器是否匹配

测试选择器是否匹配

No parameter schema in public metadata yet.

ocr屏幕文字识别

屏幕文字识别

No parameter schema in public metadata yet.

find_colors多点找色

多点找色

No parameter schema in public metadata yet.

compare_colors多点比色

多点比色

No parameter schema in public metadata yet.

create_project在设备上创建工程

在设备上创建工程

No parameter schema in public metadata yet.

upload_file上传文件到设备（自动创建工程）

上传文件到设备（自动创建工程）

No parameter schema in public metadata yet.

run_project运行工程

运行工程

No parameter schema in public metadata yet.

run_project_debug调试模式运行（Android + ADB），自动 forward 5678 端口并返回 VS Code attach 配置

调试模式运行（Android + ADB），自动 forward 5678 端口并返回 VS Code attach 配置

No parameter schema in public metadata yet.

stop_project停止运行

停止运行

No parameter schema in public metadata yet.

get_run_log获取运行日志

获取运行日志

No parameter schema in public metadata yet.

eval_python设备 Python REPL（Android + iOS）：直接在主进程 exec 代码立即拿结果，几百毫秒一轮

设备 Python REPL（Android + iOS）：直接在主进程 exec 代码立即拿结果，几百毫秒一轮

No parameter schema in public metadata yet.

list_projects列出设备上的工程

列出设备上的工程

No parameter schema in public metadata yet.

get_project_files获取工程文件树

获取工程文件树

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

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 扫描、自动连接

安装

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）。

View the full README on GitHub

Details

Repository
github.com/ascript-cn/ascript-mcp
Category
Mobile Development
Package
ascript-mcp
Transport
STDIO
Registry
MCP registry, active

Related Mobile Development MCP servers

View all
1hridaya423 avatarphonedriverhridaya423/phonedriverLet AI agents see and control Android and iOS phones over stdio.1stars
2sureshkumarm8 avatarDevicelysureshkumarm8/devicelyControl real iOS & Android devices from AI agents; mirror one tap across a whole fleet.1stars
3trysonar avatarSonartrysonar/mcpASO tools for AI agents: keyword research, rank tracking, competitor analysis (iOS & Android).0stars
4gameanalytics avatarGameAnalytics Documentationcom.gameanalytics/analytics-docsSearch GameAnalytics docs: Unity, Unreal, iOS, Android SDK and API guides for mobile game analytics.0stars
5sharminsirajudeen avatarDrengrsharminsirajudeen/drengr-communityEyes and hands for AI agents on Android and iOS devices.0stars
6devsrodrigo avatarLOCK IN — Social Media Addiction & Dopamine Resetdevsrodrigo/lockin-mcpiOS dopamine detox app with social media blocking and screen time tools.0stars