ascript-mcp

ascript-mcp

Enables AI programming tools to query AScript API documentation and control real Android/iOS devices for automation scripting, including device interaction, development deployment, and file management.

Category
Visit Server

README

ascript-mcp

<!-- mcp-name: io.github.ascript-cn/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. 规则配置

在项目根目录创建 .cursorrules 文件:

当用户需要编写设备自动化脚本(Android/iOS/Windows)时,必须使用 ascript MCP 工具连接设备、观察界面、查询 API 后再编写代码,禁止凭记忆编写 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 获取插件详细文档

设备连接(3 个)

工具 说明
auto_connect 从工程配置自动连接设备
scan_devices 扫描局域网 + ADB 设备
connect_device 手动连接指定设备

观察界面(6 个)

工具 说明
screen_capture 截取设备屏幕
dump_ui_tree 获取控件树
test_selector 测试选择器是否匹配
ocr 屏幕文字识别
find_colors 多点找色
compare_colors 多点比色

开发部署(5 个)

工具 说明
create_project 在设备上创建工程
upload_file 上传文件到设备(自动创建工程)
run_project 运行工程
stop_project 停止运行
get_run_log 获取运行日志

文件管理(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

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured
E2B

E2B

Using MCP to run code via e2b.

Official
Featured