AScript MCP server
✓ 인증됨AI 클라이언트가 Android, iOS, Windows 기기를 제어하고, API 문서를 조회하며, 자동화 프로젝트를 관리할 수 있도록 지원합니다.
다른 이름 ascript-cn/ascript-mcp
- 스타
- 9
- Tools
- —
- 다운로드, 30일
- 365
- 최신 버전
- 1.7.0
- 마지막 커밋
- 2026년 4월 30일
- 라이선스
- MIT
AScript MCP란?
AScript은(는) MCP server입니다. AI 클라이언트가 Android, iOS, Windows 기기를 제어하고, API 문서를 조회하며, 자동화 프로젝트를 관리할 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
AScript MCP server 정보
Claude Desktop, Cursor 또는 Trae와 같은 AI 코딩 도구를 통해 Android, iOS, Windows 기기를 제어하는 것이 이 server의 주요 기능입니다. 개발자는 API 문서를 조회하고, 온라인 플러그인을 검색하며, 하드웨어와 직접 상호작용하여 자동화 프로젝트를 관리할 수 있습니다. 사용자는 코드를 작성하기 전에 기기 상태를 파악하기 위해 화면 캡처, OCR, UI tree dump 등의 작업을 수행할 수 있습니다.
설정은 pip를 통해 패키지를 설치하고 IDE에서 로컬 MCP server를 구성하는 방식으로 진행됩니다. Android 및 iOS의 경우, 이 server는 기기 REPL 역할을 하는 고유한 eval_python 도구를 제공하여 즉각적인 코드 실행 및 테스트를 가능하게 합니다. 이를 통해 AI agent가 화면을 관찰하고, 셀렉터를 테스트하며, 실시간 피드백을 바탕으로 스크립트를 반복 개선하는 워크플로우를 구축할 수 있습니다. 또한 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를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
AScript MCP server를 어떻게 설치하나요?
pip install ascript-mcp 명령어를 사용하여 pip로 설치할 수 있습니다.
기기에서 직접 Python 코드를 테스트할 수 있나요?
네, eval_python 도구를 통해 Android 및 iOS 기기에서 Python REPL을 제공하므로 코드를 실행하고 즉시 결과를 확인할 수 있습니다.