mcpField
A
ascript-mcp

ascript-mcp

本地服务
github.com/ascript-cn开发工具826 周前更新
代码仓库

关于 ascript-mcp

ascript-mcp 将 AScript 文档查询和真实设备自动化能力提供给 AI 编程工具，面向编写 Android、iOS 和 Windows 自动化脚本的开发者。它涵盖从界面观察、设备 Python 调试到上传运行的流程，并支持免越狱 iOS 操作。

主要功能

  1. 01查询 API 文档与代码示例
  2. 02搜索在线插件库
  3. 03截图、控件树与 OCR 观察
  4. 04扫描、连接和管理设备
  5. 05创建、调试并运行工程

适用场景

  1. 01查询 AScript API 并编写自动化脚本
  2. 02在真实设备上检查界面并验证选择器
  3. 03通过设备 REPL 迭代调试 Python 代码
  4. 04上传并运行移动设备自动化项目

MCP 相关

提供 MCP 服务，将 AScript 文档、插件查询、设备交互与工程部署工具开放给兼容客户端。可通过本地 stdio 配置使用，也可用 SSE 模式提供仅文档查询服务。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "ascript-cn-ascript": {
      "command": "uvx",
      "args": [
        "ascript-mcp"
      ]
    }
  }
}
启动命令uvx ascript-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypiascript-mcp1.7.0

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

来自项目 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）。

这份规则模板包含：

  • 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 北京奥悦科技有限公司。

更多信息

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。