프로젝트 소개

Mobile MCP는 모바일 개발 및 자동화를 위한 Model Context Protocol(MCP) 서버입니다. 플랫폼 독립적 인터페이스를 제공하여 에이전트와 LLM이 별도의 iOS 또는 Android 전문 지식 없이도 네이티브 iOS 및 Android 애플리케이션과 상호작용할 수 있습니다. Claude Code, Codex, Gemini, GitHub Copilot, Antigravity 등 MCP 호환 클라이언트와 함께 작동하며, 로컬 머신의 기기 또는 호스팅된 클라우드 서비스를 통한 원격 기기를 대상으로 할 수 있습니다. 지원 대상에는 iOS 시뮬레이터(Xcode 및 xcrun simctl 사용), USB로 연결된 iOS 실제 기기, Android 에뮬레이터(adb 사용), USB 디버깅이 활성화된 Android 실제 기기가 포함됩니다. 이 서버는 npm 패키지로 배포되며 일반적으로 npx로 실행되고, stdio를 통해 또는 --listen 플래그를 사용한 Streamable HTTP 서버로 실행됩니다. HTTP 모드에서는 환경 변수를 통해 선택적 Bearer 토큰을 요구할 수 있습니다. 도구 세트는 기기 관리(기기 목록, 화면 크기, 방향 가져오기/설정, GPS 위치 재정의, 클립보드 읽기/교체), 앱 관리(목록, 포그라운드 앱, 실행, 종료, 설치, 제거), 화면 상호작용(스크린샷, 스크린샷 저장, 좌표가 포함된 UI 요소 목록, 탭, 더블 탭, 길게 누르기, 스와이프, 화면 녹화), 입력 및 탐색(텍스트 입력, 하드웨어 버튼, URL 열기), 로그 및 충돌 보고서(기기 로그, 충돌 목록 및 검색)를 포함합니다. 배치 명령 도구는 한 번의 호출로 여러 도구를 순차적으로 실행합니다. 원격 기기 도구를 사용하면 클라우드 제공자에 로그인하고 클라우드 기기를 나열, 할당 및 해제할 수 있습니다. 이 프로젝트는 접근성 우선 접근 방식을 강조합니다. 비전 모델이 아닌 네이티브 접근성 트리에서 앱을 구동하며, 필요할 때 스크린샷과 좌표로 대체합니다. README에서는 이를 스크린샷 전용 접근 방식보다 더 빠르고 저렴하다고 설명합니다. 출력은 구조화되고 결정론적이라고 설명됩니다. 필수 조건에는 Xcode 명령줄 도구, Android 플랫폼 도구, Node.js v20 이상, MCP 지원 에이전트 또는 모델이 포함됩니다. Amp, Antigravity, Cline, Claude Code, Claude Desktop, Codex, Copilot, Cursor, Gemini CLI, Goose, Kiro, opencode, Windsurf 등 여러 클라이언트에 대한 구성 예제가 제공됩니다. 환경 변수는 인증, 텔레메트리 옵트아웃, 안전하지 않은 URL 스킴, 레거시 로봇 모드를 제어합니다. 익명 텔레메트리는 기본적으로 수집되며 비활성화할 수 있습니다. 이 저장소는 관련 프로젝트도 가리킵니다. 반복 가능한 결정론적 모바일 테스트를 위한 mobilewright, 기반이 되는 기기 CLI인 mobilecli, 온디맨드 실제 기기를 위한 클라우드 제공이 그것입니다. 문서, 로드맵, 기여 지침, 행동 강령이 링크되어 있습니다. README에는 서버가 로컬에서 실행되고 연결된 기기와만 통신하며, 데이터 수집 세부 사항에 대해서는 별도의 개인정보 처리방침이 있다고 명시되어 있습니다.