ascript-mcp

Chinese | English

AScript MCP Service — Allows AI programming tools (Claude Desktop / Cursor / Trae) to directly query AScript API documentation and control real Android / iOS devices (iOS requires no signing or jailbreaking).

Features

• API Documentation Query: Module overview, API search, code examples, and environment setup guides

• Online Plugin Query: Real-time query of the AScript plugin library (OCR, YOLO, HID, LLMs, etc.)

• Device Interaction: Screenshots, UI trees, OCR, color finding, color comparison, and selector testing

• Development & Deployment: Create projects, upload code, run, stop, and view logs

• Device Management: LAN scanning, ADB scanning, and automatic connection

Related MCP server: magic-api-mcp-server

Installation

pip install ascript-mcp

Configuring Cursor

1. MCP Configuration

Create .cursor/mcp.json in the project root directory:

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

2. Rule Configuration

Copy the entire docs/AGENT_RULES.md into the .cursorrules (for Cursor) or CLAUDE.md / AGENTS.md (for Claude Code / other IDEs) in your automation project root.

This rule template includes:

• 5-stage standard workflow (Observe → Select Strategy → eval_python iteration → Crop if necessary → Upload and Run)

• Decision tree for API selection (UI controls → OCR → Image search → Color search)

• Orchestration examples for common tasks like auto-login, check-in, and game combat

• Anti-pattern list (guessing code, running without verification, hardcoding non-existent image paths, etc.)

Simplified rules (use only if you don't want to copy the full rules):

当用户需要编写设备自动化脚本（Android/iOS/Windows）时，必须先调用 ascript MCP 的
get_device_status 与 list_python_packages，再用 eval_python 在设备 REPL 里
验证关键代码片段，最后才 upload_file + run_project。
禁止凭记忆编写 ascript 代码。

Tool List

API Documentation (5)

Online Plugins (2)

Device Connection (5)

Observation Interface (6)

Development & Deployment (7)

File Management (2)

Online SSE Mode

If you need to deploy as a public service (API documentation query only):

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

License

MIT License, see LICENSE for details. Copyright © 2026 Beijing Aoyue Technology Co., Ltd.

More Information

• AScript Official Website: https://ascript.cn

• API Documentation: https://docs.airscript.cn

• Plugin Library: https://py.airscript.cn

• Community Forum: https://bbs.ascript.cn

• Beijing ICP Filing No. 2020040944-4