ascript-mcp 1.6.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (20) hide show
  1. ascript_mcp-1.6.1/PKG-INFO +115 -0
  2. ascript_mcp-1.6.1/README.md +104 -0
  3. ascript_mcp-1.6.1/pyproject.toml +26 -0
  4. ascript_mcp-1.6.1/setup.cfg +4 -0
  5. ascript_mcp-1.6.1/src/ascript_mcp/__init__.py +7 -0
  6. ascript_mcp-1.6.1/src/ascript_mcp/__main__.py +6 -0
  7. ascript_mcp-1.6.1/src/ascript_mcp/api_data/android.json +6793 -0
  8. ascript_mcp-1.6.1/src/ascript_mcp/api_data/ios.json +7431 -0
  9. ascript_mcp-1.6.1/src/ascript_mcp/api_data/windows.json +4785 -0
  10. ascript_mcp-1.6.1/src/ascript_mcp/api_store.py +307 -0
  11. ascript_mcp-1.6.1/src/ascript_mcp/device.py +1358 -0
  12. ascript_mcp-1.6.1/src/ascript_mcp/examples.py +366 -0
  13. ascript_mcp-1.6.1/src/ascript_mcp/local.py +1086 -0
  14. ascript_mcp-1.6.1/src/ascript_mcp/server.py +355 -0
  15. ascript_mcp-1.6.1/src/ascript_mcp.egg-info/PKG-INFO +115 -0
  16. ascript_mcp-1.6.1/src/ascript_mcp.egg-info/SOURCES.txt +18 -0
  17. ascript_mcp-1.6.1/src/ascript_mcp.egg-info/dependency_links.txt +1 -0
  18. ascript_mcp-1.6.1/src/ascript_mcp.egg-info/entry_points.txt +2 -0
  19. ascript_mcp-1.6.1/src/ascript_mcp.egg-info/requires.txt +3 -0
  20. ascript_mcp-1.6.1/src/ascript_mcp.egg-info/top_level.txt +1 -0
ascript_mcp-1.6.1/PKG-INFO ADDED
@@ -0,0 +1,115 @@
1
+ Metadata-Version: 2.4
2
+ Name: ascript-mcp
3
+ Version: 1.6.1
4
+ Summary: AScript MCP Service - 为大模型提供 ascript 自动化库 API 文档与设备交互服务
5
+ License: MIT
6
+ Requires-Python: >=3.10
7
+ Description-Content-Type: text/markdown
8
+ Requires-Dist: mcp>=1.0.0
9
+ Requires-Dist: uvicorn>=0.30.0
10
+ Requires-Dist: starlette
11
+
12
+ # ascript-mcp
13
+
14
+ AScript MCP Service — 让 AI 编程工具（Cursor / Trae）直接查询 AScript API 文档、操控 Android/iOS 设备。
15
+
16
+ ## 功能
17
+
18
+ - **API 文档查询**：模块概览、API 搜索、代码示例、环境搭建指南
19
+ - **在线插件查询**：实时查询 AScript 插件库（OCR、YOLO、HID、大模型等）
20
+ - **设备交互**：截图、控件树、OCR、找色、比色、选择器测试
21
+ - **开发部署**：创建工程、上传代码、运行、停止、查看日志
22
+ - **设备管理**：局域网扫描、ADB 扫描、自动连接
23
+
24
+ ## 安装
25
+
26
+ ```bash
27
+ pip install ascript-mcp
28
+ ```
29
+
30
+ ## 配置 Cursor
31
+
32
+ ### 1. MCP 配置
33
+
34
+ 在项目根目录创建 `.cursor/mcp.json`：
35
+
36
+ ```json
37
+ {
38
+ "mcpServers": {
39
+ "ascript": {
40
+ "command": "python",
41
+ "args": ["-m", "ascript_mcp.local"]
42
+ }
43
+ }
44
+ }
45
+ ```
46
+
47
+ ### 2. 规则配置
48
+
49
+ 在项目根目录创建 `.cursorrules` 文件：
50
+
51
+ ```
52
+ 当用户需要编写设备自动化脚本（Android/iOS/Windows）时，必须使用 ascript MCP 工具连接设备、观察界面、查询 API 后再编写代码，禁止凭记忆编写 ascript 代码。
53
+ ```
54
+
55
+ ## 工具列表
56
+
57
+ ### API 文档（5 个）
58
+ | 工具 | 说明 |
59
+ |------|------|
60
+ | `get_platform_overview` | 获取平台 API 模块概览 |
61
+ | `get_module_apis` | 获取模块详细 API 文档 |
62
+ | `search_api` | 按关键词搜索 API |
63
+ | `get_code_example` | 获取代码示例 |
64
+ | `get_setup_guide` | 获取环境搭建指南 |
65
+
66
+ ### 在线插件（2 个）
67
+ | 工具 | 说明 |
68
+ |------|------|
69
+ | `list_plugins` | 查询插件库列表 |
70
+ | `get_plugin_detail` | 获取插件详细文档 |
71
+
72
+ ### 设备连接（3 个）
73
+ | 工具 | 说明 |
74
+ |------|------|
75
+ | `auto_connect` | 从工程配置自动连接设备 |
76
+ | `scan_devices` | 扫描局域网 + ADB 设备 |
77
+ | `connect_device` | 手动连接指定设备 |
78
+
79
+ ### 观察界面（6 个）
80
+ | 工具 | 说明 |
81
+ |------|------|
82
+ | `screen_capture` | 截取设备屏幕 |
83
+ | `dump_ui_tree` | 获取控件树 |
84
+ | `test_selector` | 测试选择器是否匹配 |
85
+ | `ocr` | 屏幕文字识别 |
86
+ | `find_colors` | 多点找色 |
87
+ | `compare_colors` | 多点比色 |
88
+
89
+ ### 开发部署（5 个）
90
+ | 工具 | 说明 |
91
+ |------|------|
92
+ | `create_project` | 在设备上创建工程 |
93
+ | `upload_file` | 上传文件到设备（自动创建工程） |
94
+ | `run_project` | 运行工程 |
95
+ | `stop_project` | 停止运行 |
96
+ | `get_run_log` | 获取运行日志 |
97
+
98
+ ### 文件管理（2 个）
99
+ | 工具 | 说明 |
100
+ |------|------|
101
+ | `list_projects` | 列出设备上的工程 |
102
+ | `get_project_files` | 获取工程文件树 |
103
+
104
+ ## 线上 SSE 模式
105
+
106
+ 如需部署为公网服务（仅 API 文档查询）：
107
+
108
+ ```bash
109
+ uvicorn ascript_mcp.server:app --host 0.0.0.0 --port 8000
110
+ ```
111
+
112
+ ## 更多信息
113
+
114
+ - AScript 官网：https://airscript.cn
115
+ - API 文档：https://docs.airscript.cn
ascript_mcp-1.6.1/README.md ADDED
@@ -0,0 +1,104 @@
1
+ # ascript-mcp
2
+
3
+ AScript MCP Service — 让 AI 编程工具（Cursor / Trae）直接查询 AScript API 文档、操控 Android/iOS 设备。
4
+
5
+ ## 功能
6
+
7
+ - **API 文档查询**：模块概览、API 搜索、代码示例、环境搭建指南
8
+ - **在线插件查询**：实时查询 AScript 插件库（OCR、YOLO、HID、大模型等）
9
+ - **设备交互**：截图、控件树、OCR、找色、比色、选择器测试
10
+ - **开发部署**：创建工程、上传代码、运行、停止、查看日志
11
+ - **设备管理**：局域网扫描、ADB 扫描、自动连接
12
+
13
+ ## 安装
14
+
15
+ ```bash
16
+ pip install ascript-mcp
17
+ ```
18
+
19
+ ## 配置 Cursor
20
+
21
+ ### 1. MCP 配置
22
+
23
+ 在项目根目录创建 `.cursor/mcp.json`：
24
+
25
+ ```json
26
+ {
27
+ "mcpServers": {
28
+ "ascript": {
29
+ "command": "python",
30
+ "args": ["-m", "ascript_mcp.local"]
31
+ }
32
+ }
33
+ }
34
+ ```
35
+
36
+ ### 2. 规则配置
37
+
38
+ 在项目根目录创建 `.cursorrules` 文件：
39
+
40
+ ```
41
+ 当用户需要编写设备自动化脚本（Android/iOS/Windows）时，必须使用 ascript MCP 工具连接设备、观察界面、查询 API 后再编写代码，禁止凭记忆编写 ascript 代码。
42
+ ```
43
+
44
+ ## 工具列表
45
+
46
+ ### API 文档（5 个）
47
+ | 工具 | 说明 |
48
+ |------|------|
49
+ | `get_platform_overview` | 获取平台 API 模块概览 |
50
+ | `get_module_apis` | 获取模块详细 API 文档 |
51
+ | `search_api` | 按关键词搜索 API |
52
+ | `get_code_example` | 获取代码示例 |
53
+ | `get_setup_guide` | 获取环境搭建指南 |
54
+
55
+ ### 在线插件（2 个）
56
+ | 工具 | 说明 |
57
+ |------|------|
58
+ | `list_plugins` | 查询插件库列表 |
59
+ | `get_plugin_detail` | 获取插件详细文档 |
60
+
61
+ ### 设备连接（3 个）
62
+ | 工具 | 说明 |
63
+ |------|------|
64
+ | `auto_connect` | 从工程配置自动连接设备 |
65
+ | `scan_devices` | 扫描局域网 + ADB 设备 |
66
+ | `connect_device` | 手动连接指定设备 |
67
+
68
+ ### 观察界面（6 个）
69
+ | 工具 | 说明 |
70
+ |------|------|
71
+ | `screen_capture` | 截取设备屏幕 |
72
+ | `dump_ui_tree` | 获取控件树 |
73
+ | `test_selector` | 测试选择器是否匹配 |
74
+ | `ocr` | 屏幕文字识别 |
75
+ | `find_colors` | 多点找色 |
76
+ | `compare_colors` | 多点比色 |
77
+
78
+ ### 开发部署（5 个）
79
+ | 工具 | 说明 |
80
+ |------|------|
81
+ | `create_project` | 在设备上创建工程 |
82
+ | `upload_file` | 上传文件到设备（自动创建工程） |
83
+ | `run_project` | 运行工程 |
84
+ | `stop_project` | 停止运行 |
85
+ | `get_run_log` | 获取运行日志 |
86
+
87
+ ### 文件管理（2 个）
88
+ | 工具 | 说明 |
89
+ |------|------|
90
+ | `list_projects` | 列出设备上的工程 |
91
+ | `get_project_files` | 获取工程文件树 |
92
+
93
+ ## 线上 SSE 模式
94
+
95
+ 如需部署为公网服务（仅 API 文档查询）：
96
+
97
+ ```bash
98
+ uvicorn ascript_mcp.server:app --host 0.0.0.0 --port 8000
99
+ ```
100
+
101
+ ## 更多信息
102
+
103
+ - AScript 官网：https://airscript.cn
104
+ - API 文档：https://docs.airscript.cn
ascript_mcp-1.6.1/pyproject.toml ADDED
@@ -0,0 +1,26 @@
1
+ [build-system]
2
+ requires = ["setuptools>=61.0", "wheel"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "ascript-mcp"
7
+ version = "1.6.1"
8
+ description = "AScript MCP Service - 为大模型提供 ascript 自动化库 API 文档与设备交互服务"
9
+ readme = "README.md"
10
+ requires-python = ">=3.10"
11
+ license = {text = "MIT"}
12
+
13
+ dependencies = [
14
+ "mcp>=1.0.0",
15
+ "uvicorn>=0.30.0",
16
+ "starlette",
17
+ ]
18
+
19
+ [project.scripts]
20
+ ascript-mcp = "ascript_mcp.local:main_sync"
21
+
22
+ [tool.setuptools.packages.find]
23
+ where = ["src"]
24
+
25
+ [tool.setuptools.package-data]
26
+ "ascript_mcp" = ["api_data/*.json"]
ascript_mcp-1.6.1/setup.cfg ADDED
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
ascript_mcp-1.6.1/src/ascript_mcp/__init__.py ADDED
@@ -0,0 +1,7 @@
1
+ """ascript-mcp: AirScript 自动化库的 MCP 服务。
2
+
3
+ 让大模型通过 MCP 协议查询 ascript 的 API 文档，
4
+ 从而编写正确的 Android / iOS / Windows 自动化代码。
5
+ """
6
+
7
+ __version__ = "1.6.0"
ascript_mcp-1.6.1/src/ascript_mcp/__main__.py ADDED
@@ -0,0 +1,6 @@
1
+ """允许 python -m ascript_mcp 直接启动本地 stdio 服务。"""
2
+
3
+ import asyncio
4
+ from ascript_mcp.local import main
5
+
6
+ asyncio.run(main())