ascript-mcp — MCP-сервер для Claude Code: что делает и как установить
Связывает AI-ассистентов с мобильными устройствами на Android и iOS. Помогает проверять интерфейс, тестировать селекторы и запускать скрипты автоматизации.
claude mcp add ascript-mcp -- uvx ascript-mcpЧто делает ascript-mcp
Сервер даёт агенту инструменты для управления смартфонами и поиска по базе AScript. Ассистент умеет делать снимки экрана, считывать дерево интерфейса, распознавать надписи через OCR и сверять цвета точек. Дополнительно встроен поиск по документации API и каталогу плагинов.
Для быстрых экспериментов есть инструмент eval_python. Он запускает фрагменты кода прямо в запущенном процессе на устройстве с откликом за доли секунды. Сервер поддерживает загрузку файлов, создание проектов и запуск удалённой отладки по ADB с перенаправлением порта 5678. При работе с iOS джейлбрейк или повторная подпись приложений не понадобятся.
Подробная сводка о батарее и памяти через get_device_status доступна только для Android. Для выполнения тестов и скриптов на целевом смартфоне обязательно должно быть установлено приложение AScript.
Какие задачи решает
- инспектировать дерево элементов интерфейса и проверять селекторы на экране
- выполнять фрагменты кода на смартфоне через быстрый REPL
- распознавать текст на дисплее с помощью OCR и сравнивать цвета
- загружать файлы проекта и запускать сессию отладки через ADB
Примеры запросов агенту
- Сделай снимок экрана подключённого телефона и покажи дерево элементов.
- Найди в документации AScript примеры кликов и протестируй фрагмент через eval_python.
- Просканируй устройства в локальной сети и проверь установленные библиотеки Python.
Как установить ascript-mcp
Командой платформы
claude mcp add ascript-mcp -- uvx ascript-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from ascript-mcp <команда>
Командой платформы
codex mcp add ascript-mcp -- uvx ascript-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from ascript-mcp <команда>
Файл настроек
{
"mcpServers": {
"ascript-mcp": {
"command": "uvx",
"args": [
"ascript-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from ascript-mcp <команда>
Файл настроек
{
"servers": {
"ascript-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"ascript-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from ascript-mcp <команда>
Командой платформы
gemini mcp add ascript-mcp uvx ascript-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from ascript-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о ascript-mcp
Как установить ascript-mcp в Claude Code?
Выполните команду claude mcp add ascript-mcp -- uvx ascript-mcp в терминале.
Что делает ascript-mcp?
Сервер связывает модели с реальными устройствами на базе Android и iOS через платформу AScript. Он позволяет исследовать экран, тестировать селекторы, читать документацию и исполнять сценарии автоматизации.
Нужен ли джейлбрейк для автоматизации на iOS?
Нет, взаимодействие с iOS работает без джейлбрейка и без переподписания. При выполнении кода в REPL сервер сам переводит вызовы модулей Android в формат iOS.
