Mobile MCP — MCP 에이전트로 iOS·Android 앱 자동화

AI 요약

Mobile MCP는 Model Context Protocol(MCP) 서버로, Claude Code, Codex, Gemini, GitHub Copilot 등 MCP 호환 클라이언트에서 모바일 앱을 조작하게 합니다. iOS와 Android를 위한 별도 자동화 코드를 작성하지 않고, 자연어 지시를 바탕으로 앱 테스트나 데이터 입력, 여러 단계의 사용자 여정을 실행하는 용도입니다. macOS·Linux·Windows 환경의 시뮬레이터와 에뮬레이터, USB로 연결한 실제 기기를 지원하며, Mobile Next Cloud의 원격 기기도 같은 도구로 제어합니다.

접근성 트리와 스크린샷 기반 제어

기본 경로는 화면의 네이티브 접근성 트리에서 UI 요소와 속성을 읽는 방식입니다. 화면 내용을 구조화해 반환하므로 스크린샷만 보고 판단하는 방식보다 모호함을 줄이고, 별도 비전 모델이나 이미지 토큰을 쓰지 않는다고 설명합니다. 접근성 정보만으로 조작하기 어려울 때는 스크린샷과 좌표를 사용합니다. 화면 요소 및 좌표 조회, 탭·더블 탭·길게 누르기·스와이프, 텍스트 입력을 지원합니다.

기기 제어와 자동화 도구

MCP 도구로 연결된 기기 목록과 화면 크기·방향을 확인하고, 방향과 GPS 위치를 바꿀 수 있습니다. 앱 설치·삭제·실행·종료, URL 열기, 클립보드 읽기와 변경, 하드웨어 버튼 입력도 지원합니다. 화면 녹화와 기기 로그 수집, 크래시 목록 조회 및 보고서 확인 기능이 있어 자동화 실행뿐 아니라 문제 조사에도 활용할 수 있습니다. 여러 도구 호출을 한 번에 순서대로 실행하는 일괄 명령도 제공합니다.

설치와 전송 방식

Node.js 20 이상과 Xcode Command Line Tools, Android Platform Tools가 필요합니다. MCP 클라이언트 설정에 npx -y @mobilenext/mobile-mcp@latest를 등록하면 실행할 수 있으며, README에는 Claude Code, Codex, Cursor, Gemini CLI 등 주요 클라이언트의 설정 예시가 있습니다. 기본 통신은 stdio입니다. --listen 3000 옵션을 주면 Streamable HTTP 서버를 실행하고 /mcp 경로로 연결합니다. 이전 HTTP+SSE 방식은 더 이상 제공하지 않습니다. HTTP 서버는 MOBILEMCP_AUTH 환경 변수로 Bearer 토큰을 요구할 수 있습니다. 토큰을 설정하지 않으면 인증 없이 요청을 받으며 경고를 기록합니다. localhost 바인딩에는 Host 헤더 DNS rebinding 방어가 자동으로 적용됩니다.

개인정보와 운영 설정

사용량 텔레메트리는 PostHog와 Scarf로 익명 수집하며, MOBILEMCP_DISABLE_TELEMETRY=1로 끌 수 있습니다. 비표준 URL 스킴 허용 여부와 레거시 자동화 로봇 사용 여부도 환경 변수로 설정합니다. 프로젝트 설명에 따르면 서버는 로컬에서 실행되고 사용자가 연결한 기기와 통신합니다.

원문: GitHub / 번역·요약: Trawling