ascript-mcp
Enables AI programming tools to query AScript API documentation and control real Android/iOS devices for automation scripting, including device interaction, development deployment, and file management.
README
ascript-mcp
<!-- mcp-name: io.github.ascript-cn/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. 规则配置
在项目根目录创建 .cursorrules 文件:
当用户需要编写设备自动化脚本(Android/iOS/Windows)时,必须使用 ascript MCP 工具连接设备、观察界面、查询 API 后再编写代码,禁止凭记忆编写 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 |
获取插件详细文档 |
设备连接(3 个)
| 工具 | 说明 |
|---|---|
auto_connect |
从工程配置自动连接设备 |
scan_devices |
扫描局域网 + ADB 设备 |
connect_device |
手动连接指定设备 |
观察界面(6 个)
| 工具 | 说明 |
|---|---|
screen_capture |
截取设备屏幕 |
dump_ui_tree |
获取控件树 |
test_selector |
测试选择器是否匹配 |
ocr |
屏幕文字识别 |
find_colors |
多点找色 |
compare_colors |
多点比色 |
开发部署(5 个)
| 工具 | 说明 |
|---|---|
create_project |
在设备上创建工程 |
upload_file |
上传文件到设备(自动创建工程) |
run_project |
运行工程 |
stop_project |
停止运行 |
get_run_log |
获取运行日志 |
文件管理(2 个)
| 工具 | 说明 |
|---|---|
list_projects |
列出设备上的工程 |
get_project_files |
获取工程文件树 |
线上 SSE 模式
如需部署为公网服务(仅 API 文档查询):
uvicorn ascript_mcp.server:app --host 0.0.0.0 --port 8000
License
MIT License,详见 LICENSE。Copyright © 2026 北京奥悦科技有限公司。
更多信息
- AScript 官网:https://ascript.cn
- API 文档:https://docs.airscript.cn
- 插件库:https://py.airscript.cn
- 社区论坛:https://bbs.ascript.cn
- 京ICP备 2020040944号-4
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.
E2B
Using MCP to run code via e2b.