ascript-mcp

中文 | English

Сервис AScript MCP — позволяет инструментам программирования на базе ИИ (Claude Desktop / Cursor / Trae) напрямую запрашивать документацию API AScript и управлять реальными устройствами Android / iOS (iOS без джейлбрейка и сертификатов).

Функции

• Запрос документации API: обзор модулей, поиск API, примеры кода, руководство по настройке среды

• Поиск плагинов онлайн: поиск в библиотеке плагинов AScript в реальном времени (OCR, YOLO, HID, большие языковые модели и т. д.)

• Взаимодействие с устройством: скриншоты, дерево элементов управления, OCR, поиск цвета, сравнение цветов, тестирование селекторов

• Развертывание разработки: создание проекта, загрузка кода, запуск, остановка, просмотр логов

• Управление устройствами: сканирование локальной сети, сканирование ADB, автоматическое подключение

Related MCP server: @qirabot/mcp

Установка

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 → поиск изображения → поиск цвета)

• Примеры организации типичных задач, таких как автоматический вход в систему / регистрация / сражения в играх

• Список антипаттернов (угадывание кода из головы, запуск без проверки, жесткое кодирование несуществующих путей к изображениям и т. д.)

Краткие правила (используйте только если не хотите копировать полные правила):

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

Список инструментов

Документация API (5)

Онлайн-плагины (2)

Подключение устройств (5)

Наблюдение за интерфейсом (6)

Развертывание разработки (7)

Управление файлами (2)

Режим SSE онлайн

Если требуется развертывание в качестве общедоступного сервиса (только для запроса документации API):

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

Лицензия

Лицензия MIT, подробности см. в LICENSE. Copyright © 2026 Beijing Aoyue Technology Co., Ltd.

Дополнительная информация

• Официальный сайт AScript: https://ascript.cn

• Документация API: https://docs.airscript.cn

• Библиотека плагинов: https://py.airscript.cn

• Форум сообщества: https://bbs.ascript.cn

• 京ICP备 2020040944号-4