mobile-next/mobile-mcp

어떤 프로젝트인가요?

핵심 기능

• 01네이티브 접근성 트리로 앱을 제어하고, 필요하면 스크린샷과 좌표 기반 제어로 대체합니다
• 02iOS 시뮬레이터, Android 에뮬레이터, 실제 기기에서 동일한 도구 모음을 제공합니다
• 03앱 설치 및 실행, 제스처, 하드웨어 버튼, 딥 링크, 화면 방향 제어를 지원합니다
• 04화면 녹화, 기기 로그, 크래시 보고서 가져오기를 지원합니다
• 05stdio 또는 선택적 Bearer 토큰 인증을 사용하는 Streamable HTTP로 실행할 수 있습니다

활용 사례

• LLM 에이전트가 모바일 앱에서 여러 단계로 이뤄진 엔드투엔드 테스트 흐름을 실행하도록 합니다
• 네이티브 앱에서 반복적인 양식 작성이나 데이터 입력 작업을 자동화합니다
• AI 코딩 어시스턴트로 앱 동작을 대화형으로 탐색합니다
• 시뮬레이터나 클라우드 기기를 사용해 CI에서 모바일 자동화를 실행합니다

빠른 시작

1. 1

   Node.js v20 이상을 설치합니다

2. 2

   iOS 또는 Android 기기를 연결하거나 시뮬레이터/에뮬레이터를 시작합니다

3. 3

   표준 설정으로 MCP 서버를 에이전트에 추가합니다(npx로 실행할 수 있습니다)

   npx -y @mobilenext/mobile-mcp@latest

사용 전 알아둘 점

• !iOS에는 Xcode command line tools가, Android에는 Android Platform Tools가 필요합니다.
• !Node.js v20 이상이 필요합니다.
• !기기 미러링과 같은 일부 기능은 Ghostty 또는 kitty에서 실행되는 Claude Code에서만 작동합니다.

토픽

자주 묻는 질문

mobile-mcp은(는) 무엇인가요?

AI 에이전트와 LLM이 시뮬레이터, 에뮬레이터, 실제 기기에서 iOS·Android 앱을 자동화하도록 지원하는 MCP 서버입니다. Mobile MCP는 AI 에이전트와 LLM이 네이티브 iOS 및 Android 앱을 플랫폼에 구애받지 않고 제어할 수 있도록 해 주는 Model Context Protocol 서버입니다. iOS 시뮬레이터, Android 에뮬레이터, 실제 iOS 및 Android 기기에서 동일한 도구 모음을 사용할 수 있어 플랫폼마다 XCUITest나 Espresso 코드를 작성할 필요가 없습니다.

mobile-mcp은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

mobile-mcp은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

mobile-mcp은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. mobile-mcp의 마지막 커밋은 2026년 10월 18일입니다.

mobile-mcp은(는) 어디에 사용할 수 있나요?

LLM 에이전트가 모바일 앱에서 여러 단계로 이뤄진 엔드투엔드 테스트 흐름을 실행하도록 합니다 네이티브 앱에서 반복적인 양식 작성이나 데이터 입력 작업을 자동화합니다 AI 코딩 어시스턴트로 앱 동작을 대화형으로 탐색합니다 시뮬레이터나 클라우드 기기를 사용해 CI에서 모바일 자동화를 실행합니다

mobile-mcp는 어떻게 설치하나요?

Node.js v20 이상을 설치합니다 iOS 또는 Android 기기를 연결하거나 시뮬레이터/에뮬레이터를 시작합니다 표준 설정으로 MCP 서버를 에이전트에 추가합니다(npx로 실행할 수 있습니다): npx -y @mobilenext/mobile-mcp@latest

mobile-mcp은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/mobile-next/mobile-mcp