Serveur MCP AScript
✓ VérifiéPermet aux clients IA de contrôler des appareils Android, iOS et Windows, d'interroger la documentation d'API et de gérer des projets d'automatisation.
Aussi connu sous ascript-cn/ascript-mcp
- Étoiles
- 9
- Outils
- —
- Téléchargements, 30 jours
- 365
- Dernière version
- 1.7.0
- Dernier commit
- 30 avr. 2026
- Licence
- MIT
Qu'est-ce que AScript MCP ?
AScript est un serveur MCP. Permet aux clients IA de contrôler des appareils Android, iOS et Windows, d'interroger la documentation d'API et de gérer des projets d'automatisation.
Résumé généré à partir du README du projet
À propos du MCP server AScript
La fonction principale de ce serveur est de permettre le contrôle d'appareils Android, iOS et Windows via des outils de codage IA tels que Claude Desktop, Cursor ou Trae. Il permet aux développeurs de gérer des projets d'automatisation en interrogeant la documentation d'API, en recherchant des plugins en ligne et en interagissant directement avec le matériel. Les utilisateurs peuvent effectuer des tâches telles que des captures d'écran, de l'OCR et des dumps de l'arborescence de l'interface utilisateur (UI tree) pour comprendre l'état de l'appareil avant d'écrire du code.
La configuration nécessite l'installation du package via pip et la configuration d'un MCP server local dans votre IDE. Pour Android et iOS, le serveur propose un outil unique eval_python qui agit comme un REPL sur l'appareil, permettant l'exécution et le test immédiats de code. Cela permet un flux de travail où un agent IA peut observer l'écran, tester des sélecteurs et itérer sur des scripts grâce à un retour d'information en temps réel. Le serveur prend également en charge la recherche d'appareils via ADB ou les réseaux locaux, ainsi que la gestion complète du cycle de vie des projets, de la création à la récupération des logs.
Ce que vous pouvez faire avec
- 1Automatiser des tâches sur appareils mobilesDemandez à l'IA d'écrire et d'exécuter un script qui effectue des connexions automatiques ou des combats de jeux sur un appareil mobile connecté.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer AScript MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller AScript MCP dans Claude Code
$ claude mcp add ascript-mcp -- uvx ascript-mcpInstaller AScript MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"ascript-mcp": {
"command": "uvx",
"args": [
"ascript-mcp"
]
}
}
}Installer AScript MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"ascript-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"ascript-mcp"
]
}
}
}Installer AScript MCP dans VS Code CLI
$ code --add-mcp '{"name":"ascript-mcp","type":"stdio","command":"uvx","args":["ascript-mcp"]}'Installer AScript MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"ascript-mcp": {
"command": "uvx",
"args": [
"ascript-mcp"
]
}
}
}Installer AScript MCP dans Codex
$ codex mcp add ascript-mcp -- uvx ascript-mcpInstaller AScript MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.ascript-mcp] command = "uvx" args = ["ascript-mcp"]
Installer AScript MCP dans Gemini CLI
$ gemini mcp add -s user ascript-mcp uvx -- ascript-mcpInstaller AScript MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"ascript-mcp": {
"command": "uvx",
"args": [
"ascript-mcp"
]
}
}
}Vérifications automatisées
Exécuté le 15 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessibleascript-cn/ascript-mcp is public and reachablegithub.com/ascript-cn/ascript-mcp ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Sigstore attestation for ascript-mcppypi.org/project/ascript-mcp/ ↗Réussi
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-04-30github.com/ascript-cn/ascript-mcp ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNo popular package one edit away from ascript-mcpRéussi
- Aucun avis critique dans le package ou ses dépendances29 resolved dependencies checked; no critical advisoryosv.dev ↗Réussi
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHubascript-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
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
Questions sur AScript MCP
Comment ajouter AScript MCP à Claude Code ?
Exécutez claude mcp add ascript-mcp -- uvx ascript-mcp dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter AScript MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Comment installer le MCP server AScript ?
Vous pouvez l'installer via pip avec la commande pip install ascript-mcp.
Puis-je tester du code Python directement sur l'appareil ?
Oui, l'outil eval_python fournit un REPL Python sur l'appareil pour Android et iOS afin d'exécuter du code et d'obtenir des résultats immédiats.