MagicDesk MCP
MCP-сервер внутри Android-приложения MagicDesk: агент управляет окнами, терминалами, файлами и Linux на телефоне
- 208 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Права `shell`, `files_write` и `update` дают клиенту оболочку, запись файлов и замену APK на телефоне
- Сетевой слушатель идет по HTTP без TLS, поэтому токен и команды видны в сети без защищенного туннеля
- Даже просмотр открывает на устройстве список приложений и события, это не анонимные данные
Установка
- Работает в
Ручная установка
adb forward tcp:8765 tcp:8765Пробрасывает порт телефона на компьютер, чтобы клиент подключался к `http://127.0.0.1:8765/mcp`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Права `shell`, `files_write` и `update` дают клиенту оболочку, запись файлов и замену APK на телефоне
- Сетевой слушатель идет по HTTP без TLS, поэтому токен и команды видны в сети без защищенного туннеля
- Даже просмотр открывает на устройстве список приложений и события, это не анонимные данные
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MagicDesk — открытая рабочая станция для Android: окна приложений на нескольких экранах, терминалы, графические программы Linux через X11 и Wayland, облегченная среда Shroot с systemd, Docker и Podman. У приложения есть встроенный MCP-сервер, через который агент работает с теми же службами, что и интерфейс. Каталог инструментов охватывает состояние и события, управление экранами и окнами, действия Android, терминалы, графику, файлы, буфер обмена, темы оформления, диалоги, уведомления, обновление APK и самопроверки. Для сессий Linux добавлены семантическая автоматизация интерфейса через AT-SPI2 и типизированный доступ к D-Bus. Сервер выключен по умолчанию. Включается в настройках приложения (Settings, Automation) и слушает `http://127.0.0.1:8765/mcp`, каждый запрос требует сгенерированный токен. С компьютера до телефона доходит команда `adb forward tcp:8765 tcp:8765`. Тот же набор команд доступен во встроенной утилите `magicdesk` в консоли приложения и через Android App Functions для системных агентов на Android 16 и новее.
Для кого. Владельцам Android-телефонов с Android 14 и новее, которые используют MagicDesk как рабочее место и хотят поручать агенту рутину на устройстве.
Подходит, если
- Нужно из Claude Code на компьютере открыть терминал на телефоне и прочитать логи или запустить скрипт
- Тест мобильного приложения требует нажатий, ввода и ожидания состояния окна на реальном устройстве
- Файлы надо передать между компьютером и телефоном без облака, через загрузку и выгрузку по соединению
- Агенту нужно управлять Linux-программой на телефоне через дерево доступности AT-SPI2
- Оформление рабочего стола меняется скриптом: предпросмотр темы, подтверждение или отмена
Не подходит, если
- Нужен только ADB-доступ к чужому устройству: MagicDesk требует установки и настройки приложения на самом телефоне
- Устройство с Android 13 и старше: APK рассчитан минимум на Android 14, а управляемый рабочий стол требует Android 15
- Телефон подключен к недоверенной сети: сетевой MCP идет по HTTP без TLS и не должен смотреть в интернет напрямую
- Права `shell` или `update` не хочется отдавать клиенту: они открывают широкий доступ к системе приложения
Пример запроса к агенту
Открой терминал на телефоне, выведи последние 50 строк лога приложения и скачай файл отчета на компьютер.MCP
- Транспорт
- http
- Авторизация
- API-ключ
Ограничения
APK рассчитан на Android 14 и новее, управляемый рабочий стол требует Android 15, а привилегированные функции работают через Shizuku, совместимого провайдера вроде Shevery или опциональный root. Терминалы Termux и графика Linux на Termux могут обойтись без привилегированной службы.
Сервер по умолчанию выключен, права выдаются раздельно для локального и сетевого слушателя. Сетевой MCP работает по HTTP без TLS, поэтому нужны доверенная сеть или защищенный туннель. В README подчеркнуто, что описание относится к выбранной ветке, и стабильный APK может не содержать всех возможностей: сверяйтесь с заметками релиза или берите сборку `development`.
Как отключить. Выключите переключатель локального MCP-сервера в настройках приложения (Settings, Automation): при этом права сбрасываются, а сетевой доступ закрывается. Кнопка замены токена сразу делает недействительными все подключенные клиенты. Из клиента сервер удаляется обычным способом.
Частые вопросы
Как подключить MagicDesk к Claude Code?
В приложении включите Local MCP automation server и скопируйте подключение, затем на компьютере выполните `adb forward tcp:8765 tcp:8765` и добавьте сервер Streamable HTTP с адресом `http://127.0.0.1:8765/mcp` и заголовком `Authorization: Bearer` с вашим токеном.
Нужны ли root или Shizuku?
Для обычных терминалов и графики Linux на Termux не нужны ни root, ни Shizuku, и MCP-сервер тоже не обязателен. Управляемый рабочий стол и привилегированные функции работают через Shizuku, совместимого провайдера или root.
Что агент может делать по умолчанию?
Только наблюдать: состояние устройства, списки задач и приложений, диагностику и события. Эти данные могут содержать названия приложений. Управление, ввод, файлы, оболочка и обновление APK выдаются отдельными правами.
Безопасно ли открывать сервер по сети?
Сетевой доступ включается отдельно, привязывается к выбранному частному адресу IPv4 и порту выше 1023, но идет по HTTP без TLS. Используйте доверенную сеть или защищенный туннель, прямой выход в интернет исключите.
Есть ли способ обойтись без MCP?
Да: встроенная утилита `magicdesk` в консоли приложения дает ту же каталожную систему команд без включенного MCP и без Python. Для системных агентов на Android 16 и новее есть Android App Functions.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для управления Android-устройством через ADB: навигация по приложениям, ввод и авто-тесты
MCP-сервер дает агенту экран Android, поиск элементов, нажатия, ввод и снимки для проверки собственных приложений.
Android MCP Server — управление Android через ADB
Android MCP Server
MCP-сервер на Python: агент делает снимок экрана Android-устройства, читает кликабельные элементы интерфейса и выполняет команды ADB
Android Remote Control MCP
android-remote-control-mcp
Приложение Android, которое превращает телефон или эмулятор в сервер MCP: службы доступности и снимки экрана
62 MCP-инструмента, чтобы агент нажимал, листал и вводил текст на реальном Android по ADB или на iPhone.
MCP-сервер для управления iOS и Android: симуляторы, эмуляторы и реальные устройства через дерево доступности и скриншоты
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| MagicDesk (эта карточка) | нет | API-ключ | 208 | |
| Android Remote Control MCP | нет | OAuth | 784 | приложение, которое превращает телефон в сервер MCP через службу доступности и снимки экрана, без терминалов и Linux |
| Android MCP | нет | не нужна | 917 | управление Android через ADB с компьютера, без приложения на телефоне |
Коротко о README
Описание проекта рассказывает о рабочем столе на нескольких экранах, инструментах без рабочего стола, Linux через Shroot, портативных рабочих местах и настройке. Автоматизация разобрана в `docs/automation.md`, отдельный Android-интерфейс `RUN_COMMAND` для запуска команд сторонними приложениями описан в `docs/run-command.md`. Есть сообщество в Telegram и на Reddit и бот поддержки.