Skip to main content

MCP服务

tip

新版 MCP 服务页面已独立为产品页，请访问：MCP服务

AScript MCP Service 是面向 AI 编程工具的 AScript 能力桥接服务。接入后，Cursor、Claude Desktop、Trae 等支持 MCP 的工具可以直接查询 AScript API 文档、搜索在线插件，并在本地模式下连接真实 Android / iOS 设备，完成截图、控件树分析、OCR、上传代码、运行工程、查看日志等自动化开发流程。

开源项目地址：ascript-cn/ascript-mcp

两种使用方式​

官方线上 MCP​

如果你只需要让 AI 编程工具查询 AScript API 文档和在线插件库，可以直接使用官方线上 SSE 服务：

https://mcp.ascript.cn/sse

该服务适合文档查询、API 搜索、代码示例获取、插件信息查询等场景。它不连接你的本地设备，也不会上传或运行你的本地工程。

连通性检查：

curl -I https://mcp.ascript.cn/sse

正常情况下会返回类似下面的响应：

HTTP/1.1 200 OK
Content-Type: text/event-stream; charset=utf-8
tip

访问 https://mcp.ascript.cn 根路径返回 404 Not Found 是正常现象。MCP 客户端需要连接的是 /sse 地址。

Cursor / Trae 等支持远程 SSE MCP 的工具，可以按下面方式配置：

{
  "mcpServers": {
    "ascript-docs": {
      "url": "https://mcp.ascript.cn/sse"
    }
  }
}

如果你的 MCP 客户端不支持直接填写 SSE URL，可以使用 mcp-remote 作为转接：

{
  "mcpServers": {
    "ascript-docs": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.ascript.cn/sse"]
    }
  }
}

本地 MCP​

本地 MCP 运行在你的电脑上，适合真实设备自动化开发。

它可以连接本机或局域网内的 Android / iOS 设备，让 AI 编程工具具备“先观察设备，再写代码，再上传运行，再看日志迭代”的闭环能力。

适合场景：

  • 编写 Android / iOS 自动化脚本
  • 调试真实设备上的控件、OCR、图色、选择器
  • 让 AI 根据设备当前画面生成更准确的 AScript 代码
  • 上传文件、运行工程、停止工程、读取运行日志

安装：

pip install ascript-mcp

Cursor 配置示例：

{
  "mcpServers": {
    "ascript": {
      "command": "python",
      "args": ["-m", "ascript_mcp.local"]
    }
  }
}

服务器端 MCP​

服务器端 MCP 适合部署为公网服务，主要用于 API 文档查询能力。

它不直接控制你的本地设备，更适合团队共享、云端文档检索、AI 工具统一接入 AScript 文档能力等场景。

启动示例：

uvicorn ascript_mcp.server:app --host 0.0.0.0 --port 8000

核心能力​

API 文档查询​

  • 获取 Android / iOS / Windows 平台 API 模块概览
  • 查询模块下的 API 详情
  • 按关键词搜索 API
  • 获取代码示例
  • 获取环境搭建指南

在线插件查询​

  • 查询 AScript 在线插件库
  • 查看 OCR、YOLO、HID、大模型等插件详情
  • 帮助 AI 在写代码前选择合适的插件能力

设备观察与调试​

  • 截取设备屏幕
  • 获取控件树
  • 测试选择器是否匹配
  • 调用 OCR 识别屏幕文字
  • 多点找色、比色
  • 查询设备状态与已安装 Python 包

开发部署​

  • 创建设备工程
  • 上传代码文件
  • 运行或停止工程
  • 获取运行日志
  • 使用设备 Python REPL 快速验证代码片段

推荐工作流​

接入本地 MCP 后，建议让 AI 遵循下面的流程开发自动化脚本：

  1. 先获取设备状态与运行环境
  2. 再截图、读取控件树或 OCR，确认当前页面
  3. 根据页面选择控件、OCR、找图或找色策略
  4. 用设备 Python REPL 验证关键代码片段
  5. 上传完整工程并运行
  6. 根据日志和画面继续迭代

这样可以减少“凭记忆写代码”的误差，让 AI 编写的 AScript 脚本更贴近真实设备状态。

适合谁使用​

  • 想用 Cursor / Claude Desktop / Trae 编写 AScript 的开发者
  • 需要让 AI 理解 AScript API 与插件生态的团队
  • 需要在真实 Android / iOS 设备上快速验证自动化逻辑的开发者
  • 希望把 API 文档查询能力部署为团队公共服务的使用者

相关链接​