AScript MCPサーバー
✓ 検証済みAIクライアントによるAndroid、iOS、Windowsデバイスの制御、APIドキュメントの照会、および自動化プロジェクトの管理を可能にします。
別名 ascript-cn/ascript-mcp
- スター
- 9
- ツール
- —
- ダウンロード数（30日間）
- 365
- 最新バージョン
- 1.7.0
- 最終コミット
- 2026年4月30日
- ライセンス
- MIT
AScript MCPとは
AScriptはMCPサーバーです。 AIクライアントによるAndroid、iOS、Windowsデバイスの制御、APIドキュメントの照会、および自動化プロジェクトの管理を可能にします。.
プロジェクトのREADMEから生成された概要
AScript MCP server について
Claude Desktop、Cursor、TraeなどのAIコーディングツールを通じて、Android、iOS、Windowsデバイスを制御することがこのサーバーの主な機能です。APIドキュメントの照会、オンラインプラグインの検索、ハードウェアとの直接的な対話を行うことで、開発者は自動化プロジェクトを管理できます。ユーザーは、コードを書く前にデバイスの状態を把握するために、スクリーンショットの取得、OCR、UIツリーのダンプなどのタスクを実行できます。
セットアップには、pipによるパッケージのインストールと、IDEでのローカルMCP serverの設定が必要です。AndroidおよびiOSでは、このサーバーはデバイスのREPLとして機能する独自の eval_python ツールを提供し、即時のコード実行とテストを可能にします。これにより、AIエージェントが画面を観察し、セレクターをテストし、リアルタイムのフィードバックを用いてスクリプトを改善していくワークフローが実現します。また、ADBまたはローカルネットワーク経由でのデバイスのスキャンや、プロジェクトの作成からログ取得までのライフサイクル全体の管理もサポートしています。
できること
- 1モバイルデバイスのタスク自動化接続されたモバイルデバイス上で、自動ログインやゲームの戦闘を行うスクリプトの作成と実行をAIに依頼できます。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
AScript MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにAScript MCPをインストール
$ claude mcp add ascript-mcp -- uvx ascript-mcpCursorにAScript MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"ascript-mcp": {
"command": "uvx",
"args": [
"ascript-mcp"
]
}
}
}VS CodeにAScript MCPをインストール
.vscode/mcp.json
{
"servers": {
"ascript-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"ascript-mcp"
]
}
}
}VS Code CLIにAScript MCPをインストール
$ code --add-mcp '{"name":"ascript-mcp","type":"stdio","command":"uvx","args":["ascript-mcp"]}'Claude DesktopにAScript MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"ascript-mcp": {
"command": "uvx",
"args": [
"ascript-mcp"
]
}
}
}CodexにAScript MCPをインストール
$ codex mcp add ascript-mcp -- uvx ascript-mcpCodex config.tomlにAScript MCPをインストール
~/.codex/config.toml
[mcp_servers.ascript-mcp] command = "uvx" args = ["ascript-mcp"]
Gemini CLIにAScript MCPをインストール
$ gemini mcp add -s user ascript-mcp uvx -- ascript-mcpGemini settings.jsonにAScript MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"ascript-mcp": {
"command": "uvx",
"args": [
"ascript-mcp"
]
}
}
}自動チェック
実行日 2026年11月15日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能ascript-cn/ascript-mcp is public and reachablegithub.com/ascript-cn/ascript-mcp ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)Sigstore attestation for ascript-mcppypi.org/project/ascript-mcp/ ↗合格
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-04-30github.com/ascript-cn/ascript-mcp ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from ascript-mcp合格
- パッケージおよびその依存関係に重大な勧告なし29 resolved dependencies checked; no critical advisoryosv.dev ↗合格
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
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 的 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
AScript MCPのよくある質問
AScript MCPをClaude Codeに追加するには
ターミナルでclaude mcp add ascript-mcp -- uvx ascript-mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
AScript MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
AScript MCP serverのインストール方法を教えてください。
pip install ascript-mcp コマンドを使用して、pip経由でインストールできます。
デバイス上で直接Pythonコードをテストできますか？
はい、eval_python ツールがAndroidおよびiOS向けにデバイス上のPython REPLを提供するため、コードを実行して即座に結果を取得できます。