에이전트가 플랫폼별 지식(XCUITest, Espresso) 없이 iOS·Android 앱을 조작하게 하는 mcp 서버. 화면을 스크린샷 대신 네이티브 접근성 트리로 읽고, 필요할 때만 스크린샷+좌표 탭으로 폴백한다.
개요
Mobile Next가 만든 TypeScript MCP 서버(Apache-2.0)로, 2026-10-02 기준 ★8.5k·포크 753·기여자 30명, 최신 릴리스 1.0.8이다. npx -y @mobilenext/mobile-mcp@latest 한 줄로 Claude Code·Codex·Gemini·Copilot·Antigravity 등 MCP 클라이언트에 붙는다. 필요 환경은 Node 20+, Xcode CLI 도구, Android Platform Tools이다.
핵심 설계
- 접근성 우선:
mobile_list_elements_on_screen으로 UI 요소를 좌표·속성과 함께 읽어 비전 모델·이미지 토큰 없이 구동한다. 스크린샷은 폴백이다. - 하나의 API, 네 가지 타깃: iOS 시뮬레이터(
xcrun simctl), iOS 실기기(USB 신뢰 필요), Android 에뮬레이터·실기기(adb, USB 디버깅). - 구성: README상
mobilecli가 기반 장치 CLI이고, 결정론적 테스트로 옮겨가는 후속 도구로mobilewright(“Playwright for mobile”)를 제시한다. 소스package.json에도mobilewright의존성이 있다. - 내부 교체(로드맵 “Done”): 2026-05~09에 WebDriverAgent·go-ios 의존을 걷어내고 자체 Device Kit으로 대체, Android 에이전트를 실행 파일에 dex로 내장(기기에 아무것도 설치하지 않음), 백그라운드 데몬으로 호출 지연을 초 단위에서 밀리초 단위로 줄였다고 밝힌다(자체 주장).
도구 (33개)
| 범주 | 주요 도구 |
|---|---|
| 기기 | 목록·화면 크기·방향 조회/설정·폴더블 접기·GPS 위치 덮어쓰기·클립보드 |
| 앱 | 목록·전면 앱·실행·종료·설치(.apk/.ipa/.app/.zip)·삭제 |
| 화면 | 스크린샷·저장·요소 목록·탭·더블탭·롱프레스·스와이프·화면 녹화 |
| 입력 | mobile_type_keys, mobile_press_button(HOME/BACK/볼륨 등), mobile_open_url |
| 로그·크래시 | logcat/unified log 수집, 크래시 리포트 목록·조회 |
| 배치 | mobile_batch_commands — 여러 도구를 한 호출로 순차 실행 |
| 클라우드 | 로그인·원격 기기 목록·예약·반납(Mobile Next Cloud, 상용 서비스) |
로드맵의 미구현 항목은 파일 시스템 도구, 핀치 줌, WebView·Flutter UI 지원, 온디바이스 브라우저 제어, 기기 설정(다크 모드·시간대·비행기 모드), 앱 저장소 초기화다. WebView·Flutter가 빠져 있어 하이브리드 앱에서는 요소 트리가 비어 보일 수 있다는 점은 소스에서 추론한 것이며 직접 검증하지 않았다.
Claude Code 연동
/plugin marketplace add mobile-next/mobile-mcp 후 /plugin install mobile-mcp@mobile-mcp로 MCP 서버와 /mobile-mirror를 설치한다. 이 명령은 Ghostty·kitty(kitty graphics protocol 지원 터미널)의 사이드 패널에 기기 실시간 화면을 띄우고, 클릭=탭·키 입력·Home/Back 버튼을 지원한다. 플러그인 없이는 claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp@latest로 서버만 추가한다.
보안·운영 주의
- 공식 SECURITY.md가 “에이전트가 호출하는 도구를 확인하라, 기기 전체에 접근 가능하니 전용 기기를 쓰라”고 권고한다.
mobile_open_url은 비표준 URL 스킴을 기본 차단하며MOBILEMCP_ALLOW_UNSAFE_URLS=1로 해제한다.--listen으로 Streamable HTTP(/mcp)를 열 수 있고MOBILEMCP_AUTH로 Bearer 토큰을 강제한다(2026-09-11 추가, 이전 SSE 대체).- 익명 텔레메트리(PostHog·Scarf)가 기본 켜져 있다. 끄려면
MOBILEMCP_DISABLE_TELEMETRY=1.
비슷한 도구와 위치
접근성 트리 스냅샷으로 모바일을 제어한다는 발상은 2026-04-04-agent-device-mobile-cli(CLI+세션 방식)와 같고, mobile-mcp는 이를 MCP 도구 표면으로 제공한다는 점이 다르다. 브라우저의 같은 계열은 2026-03-21-chrome-devtools-mcp-autoconnect, 데스크톱은 2026-07-18-pytorchkr-topic-11298-open-computer-use-ai-mcp를 참고. Android 쪽 공식 흐름은 2026-04-17-android-cli-any-agent-faster, Mac 위에 가상 iPhone을 띄우는 보안 연구용 경로는 2026-10-04-github-lakr233-vphone-cli. 허브는 moc-mobile-ai·moc-mcp.
한계와 미확인 사항
- 속도·토큰 절감 주장은 README의 설명이며 독립 벤치마크는 확인하지 못했다.
package.jsonversion(0.0.1)과 릴리스 태그(1.0.8)가 달라, 버전은 릴리스 태그를 기준으로 봐야 한다.- 클라우드 기기 도구는 Mobile Next Cloud 계정이 필요한 상용 연동이며 가격은 확인하지 않았다.
- 실제 기기에서 도구를 실행해 검증하지는 않았다(README·로드맵·SECURITY 문서 기준 정리).
- 같은 도구 이름 체계를 따라 클라우드 iPhone·Android 에뮬레이터를 붙이는 호스티드 대안: 2026-11-03-github-phone-harness-mcp.