MCP server AppScreenMap
Коммит 27 окт. 2026 г.Позволяет ИИ-агенту составлять карту экранов мобильных приложений, проводить аудит доступности и управлять эмуляторами Android или симуляторами iOS.
Также известен как MKS-01/appscreenmap
- Звёзды
- 3
- Инструменты
- 5
- Загрузки, 30 дней
- —
- Последняя версия
- —
- Последний коммит
- 27 окт. 2026 г.
- Лицензия
- MIT
Что такое AppScreenMap MCP?
Позволяет ИИ-агенту составлять карту экранов мобильных приложений, проводить аудит доступности и управлять эмуляторами Android или симуляторами iOS. Он предоставляет 5 инструментов, например route, where_am_i, go_to_screen.
Сводка сгенерирована из README проекта
О AppScreenMap MCP server
AppScreenMap позволяет мобильным разработчикам и QA-инженерам составлять карту структуры мобильных приложений и проводить аудит доступности прямо через ИИ-агента. Подключаясь к Android эмулятору или iOS Simulator, сервер дает агенту возможность исследовать сборки, инвентаризировать экраны и определять маршруты навигации без необходимости в исходном коде, SDK или test IDs. Он работает как локальный stdio server, то есть считывает папки запусков на вашей машине и взаимодействует с вашими устройствами, не требуя API ключей, аккаунтов или внешних сетевых вызовов.
Пользователи взаимодействуют с сервером через такие инструменты, как crawl для построения карты приложения, route для поиска путей навигации и a11y_findings для выявления проблем с соответствием стандартам WCAG 2.2. Система генерирует обычные файлы, включая map.json и отчеты о производительности, которые могут быть запрошены такими клиентами, как Claude Desktop, Cursor или VS Code. Такая конфигурация позволяет агенту перемещать устройство на определенные экраны с помощью go_to_screen или проверять существующие пути, чтобы убедиться в отсутствии регрессий в новой сборке.
Что вы можете с ним делать
- 1Аудит соответствия мобильных приложений стандартам доступностиПопросите вашего ИИ-агента проверить последнюю версию приложения на соответствие стандартам WCAG 2.2 AA.
- 2Инвентаризация экранов приложенияПоручите агенту исследовать новый APK, чтобы создать полный список всех экранов в сборке.
- 3Сравнение сборок на предмет измененийИспользуйте агента, чтобы определить, какие экраны были добавлены, удалены или изменены между двумя разными версиями.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Инструменты AppScreenMap MCP 5
Определено из READMEroutewhere_am_igo_to_screencrawlcrawl_status
| route | — | |
| where_am_i | — | |
| go_to_screen | — | |
| crawl | — | |
| crawl_status | — |
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Еще не проверено. Для сервера требуется оценка 80, отсутствие серьезных проблем и достаточно данных для нашей проверки. Как работают проверки · Что исправить, чтобы получить больше баллов
- Связанный и доступный исходный репозиторийmks-01/appscreenmap is public and reachablegithub.com/mks-01/appscreenmap ↗Пройдено
- Пакет указывает этот репозиторий как источникНе проверялось
- Происхождение сборки (аттестация Sigstore)Не проверялось
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-10-27github.com/mks-01/appscreenmap ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетНе проверялось
- Нет критических предупреждений в пакете или его зависимостяхНе проверялось
- Нет скрытых инструкций для модели5 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыNo tool named like delete, drop or execПройдено
- Удалённая конечная точка отвечает на рукопожатие MCPНе проверялось
README
Открыть на GitHubappscreenmap crawl --apk app.apk # explore the app, then run `appscreenmap` to browse the map
[!NOTE] Early alpha: the project is under active development and commands may change.
Know your app
Ask a team "how many screens does your app have, and how do I reach checkout?" and you get a guess. The answer lives in someone's head, a stale design file, or a test suite that breaks every sprint. AppScreenMap walks through the build you already ship and writes every screen down, so the answer is a file you can query, diff and build on.
- What is in this build? A complete screen inventory, including screens nobody remembers.
- How do I reach Settings? A route to every screen, for you and for your agent.
- What changed since the last release? Added, removed and changed screens, before release.
- Is it accessible, fast, secure, store-ready? WCAG 2.2, performance, store deadlines and security, each with the fix and an official source.
- What does the app talk to? The hosts it calls and its own log lines, tied to the screen you were on (
crawl --network,watch). - Did this build break a path?
verifyreplays every path and fails the CI job if one is gone.
It makes no model calls while it explores, so the same build gives the same map, and nothing leaves your machine. Android and iOS (iOS is beta).
Get started
Needs macOS, uv, Bun, and an Android emulator or device (adb),
or Xcode with a booted Simulator for iOS.
git clone https://github.com/MKS-01/appscreenmap && cd appscreenmap
make install # engine, dashboard and the `appscreenmap` command
appscreenmap setup # checks adb, devices, simulators; says what is missing
appscreenmap crawl --apk app.apk # explore the app
appscreenmap # terminal home + dashboard
No app handy? Press x in the terminal home to map the Playground sample app.
- Output is a run folder of plain files (
map.json,screens/,flows/,a11y.json,perf.json, reports).map.jsonis a versioned contract: docs/MAP_SCHEMA.md. - Another language: add
--locale fr-FR(orja,ar, …). Android 13+; on iOS the app is relaunched. - Commands:
appscreenmap --helplists them all. After pulling new code, runmake installagain.
AI agent and MCP
Everything can run through your AI agent. Press t in the terminal home for a new terminal in the same folder, run
claude, and ask in plain language:
Map my app on the emulator and review the map. Audit accessibility on the latest run at WCAG 2.2 AA. Map the new build and compare it with the last run. Two screens got merged in the last map. Fix it and map again.
The agent works through the MCP server, so it answers from the map instead of exploring the app again, and its work shows up live in the dashboard:
You: How do I reach Settings? Agent →
route("Settings"): From launch: tap Profile, then tap Settings. Here is the test flow. You: Take the emulator there. Agent →go_to_screen("Settings")→where_am_i(): Done, the device is on Settings.
Connect
appscreenmap mcp serves your mapped runs to any MCP client (Claude Code, Claude Desktop, Cursor, VS Code, …). It
is a local stdio server: it reads runs/ on your machine and talks to your emulator or Simulator, with no account,
no API key and no network calls.
claude mcp add appscreenmap -- appscreenmap mcp
Other clients take the same command in their MCP config:
{ "mcpServers": { "appscreenmap": { "command": "appscreenmap", "args": ["mcp"] } } }
Options: --runs <dir> (default ./runs), --run <run-id> (default: the latest finished run), --serial <device>.
Tools
| Tool | Answers | Kind |
|---|---|---|
list_runs, list_screens, find_screens |
What has been mapped; which screen is "Settings" or has a "Save" button | read-only |
get_screen, screenshot |
One screen: elements and where each leads, how to reach it, findings, load time, image | read-only |
route |
Steps to a screen, from launch or another screen (with its test flow) | read-only |
a11y_findings, perf_summary |
Which screens fail which WCAG 2.2 criteria; which are slow | read-only |
where_am_i |
Which mapped screen the device shows now | read-only |
go_to_screen |
Drive the device to a screen along its route | drives the device |
crawl |
Map an app (or a new build) in the background | drives the device |
crawl_status |
Follow a running map | read-only |
Tools carry MCP annotations (readOnlyHint, destructiveHint), so clients can ask before go_to_screen and crawl,
the two that drive the device. More in docs/SETUP.md.
Dashboard
appscreenmap serve opens it on runs/. No backend; it updates live while it maps.
- Insights: scored audits with findings, fixes and official sources
- Map: every screen as a tree, graph or storyboard. Comment, add planned screens, file screens the crawl missed, rename, move or remove; edits go in
notes.jsonand the mapped data is never touched - Screens: search, tappable overlays, transitions, the test flow
- Accessibility: findings per rule with screenshots; triage them, export a WCAG 2.2 report
- Network · Logs: the hosts the app called and its own log lines, with sessions you recorded by hand
- Compare: what changed between two builds
- Crawl replay: step through what was tapped and why
Export the map as one self-contained SVG (every screenshot inside) or Markdown/CSV from the dashboard, or take the files
straight from the run: test flows (flows/, Maestro format), a Mermaid graph (map.mmd), a one-file WCAG report
(a11y-report.html, evidence not a conformance claim), and map.json / a11y.json / perf.json.
License
Open source under the MIT License. © 2026 MKS and AppScreenMap contributors.
Built with Claude Code.
Вопросы о AppScreenMap MCP
Какие инструменты предоставляет AppScreenMap MCP?
Он предоставляет 5 инструментов, включая route, where_am_i, go_to_screen, crawl, crawl_status.
Требуется ли для AppScreenMap SDK или исходный код?
Нет, он работает без использования SDK, test IDs или доступа к исходному коду.
Как MCP server обрабатывает данные и обеспечивает конфиденциальность?
Это локальный stdio server, который читает файлы на вашем устройстве и взаимодействует с эмулятором без сетевых запросов и необходимости создания аккаунтов.
Какие виды аудита может проводить инструмент?
Инструмент выполняет аудит доступности на соответствие WCAG 2.2, проверку производительности, готовности к публикации в сторах и безопасности.
Может ли ИИ-агент управлять мобильным устройством?
Да, агент может использовать такие инструменты, как go_to_screen, чтобы переместить устройство на конкретный экран по построенному маршруту.