mobile-next/mobile-mcp

iOS/Android 앱 자동화를 위한 MCP 서버로, 에이전트와 LLM이 모든 플랫폼에서 네이티브 앱을 제어할 수 있게 해줍니다.

설치형 도구맘대로 써도 됨 · Apache-2.0MCP·클로드 연동TypeScript난이도
5,955+60이번 주0
512포크39이슈
데모·홈페이지 열기mobilenext.ai

중간맛 분석

TypeScript 기반의 MCP(Model Context Protocol) 서버로, Claude Code, Codex, Gemini, GitHub Copilot 등 주요 AI 에이전트와 통합됩니다. 핵심은 접근성 우선(스크린샷 대신 UI 엘리먼트 구조 읽기)으로 빠르고 저비용 자동화를 제공합니다. iOS(시뮬레이터/실기기), Android(에뮬레이터/실기기) 모두 지원하며, 설치 후 npx @mobilenext/mobile-mcp@latest 한 줄로 모든 IDE/도구에 연결할 수 있습니다. 데모: 자연어로 '비디오 검색 → 좋아요 → 댓글 달기 → 공유' 같은 멀티스텝 워크플로를 자동 실행.

이런 레포예요

이럴 때 쓰면 좋아요

  • 테스트 자동화: 복잡한 사용자 여정(로그인 → 검색 → 구매 → 리뷰)을 자연어로 명령하면 에이전트가 자동으로 수행
  • 앱 스크래핑/데이터 추출: 모바일 앱에서 구조화된 UI 데이터를 읽어 정보 수집 자동화
  • AI 에이전트 워크플로우: 복수 앱 간 크로스 플랫폼 상호작용 (유튜브 검색 → WhatsApp 공유 → 캘린더 등록 등)

핵심 기능

플랫폼 무관 단일 API (iOS/Android/시뮬레이터/에뮬레이터/실기기 동일 인터페이스)접근성 우선 (스크린샷 비용 절감, 빠른 응답)모든 MCP 에이전트와 호환 (Claude, Copilot, Gemini, Cursor, Cline 등)

대안 대비 차별점

Appium이나 Espresso와 달리 플랫폼별 코드 작성 불필요하며, 모든 MCP 에이전트에 기본 통합되고, 접근성 트리 우선으로 비전 모델 비용 없이 빠른 자동화를 제공합니다.

먹어본 사람들

실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.

시식평 · 먹어본 사람 한마디

아직 시식평이 없어요. 먹어보셨다면 첫 한마디를 남겨주세요.

다른 레포 시식평 구경하기 →

이 레포로 만든 것들

🖋 완주 인증하기

아직 이 레포로 만든 완주 인증이 없어요. 첫 밥도장을 찍어보세요!

이 레포, 해먹는 법

처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.

준비물

  • Xcode 커맨드라인 도구
  • Android Platform Tools
  • Node.js v20+
  • MCP 호환 에이전트 (Claude, Copilot, Gemini 등)
  • iOS 실기기 연결 시: go-ios, WebDriverAgent, iOS 터널

바로 차려먹기Node.js (npm)

깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.

git clone --depth 1 https://github.com/mobile-next/mobile-mcp.git &&
cd mobile-mcp &&
npm install

실행 명령은 README를 확인하세요.

코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.

README가 안내하는 자세한 단계 보기
  1. 사전 요구사항 설치
# macOS/Linux: Xcode 커맨드라인 도구
xcode-select --install

# Android Platform Tools 설치
brew install android-platform-tools  # macOS
# 또는 수동 다운로드: https://developer.android.com/tools/releases/platform-tools

# Node.js v20+ 설치
brew install node
  1. 시뮬레이터/에뮬레이터 부팅 (선택)
# iOS 시뮬레이터 부팅
open -a Simulator

# 또는 Android 에뮬레이터
emulator -avd <emulator_name> &
  1. MCP 서버 설정 (Claude Code 예시)
claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp@latest
  1. 다른 도구별 설정: VS Code Cursor의 경우 설정 UI에서 command 타입으로 npx -y @mobilenext/mobile-mcp@latest 입력. Claude Desktop, Cline, Copilot 등은 각각 ~/.config 아래 JSON 설정 파일에 위 명령어 추가.

  2. 연결 확인

# 에이전트에게 지시
# "list available devices"
# 또는 CLI로 직접 테스트
npx @mobilenext/mobile-mcp@latest
  1. SSE 서버 모드 (선택, 원격 접근)
npx @mobilenext/mobile-mcp@latest --listen 3000

인증 필요시:

MOBILEMCP_AUTH=my-secret-token npx @mobilenext/mobile-mcp@latest --listen 3000

깃밥트라이로 맛보기

받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.

터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.

npx gitbap-try mobile-next/mobile-mcp

Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →

별 추이 · 7일

5,955+60 / 7일

활용성 · 따라 만들기 좋은가

샘플 점수 34/100
  • 관대한 라이선스
  • 테스트 있음
  • 예제 디렉토리
  • 최근 활동
  • AGENTS.md
  • llms.txt
  • 템플릿

🟢 최근 활동 있음 · 2025년 생성

「MCP·클로드 연동」 이런 레포, 매주 받아보실래요?

매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.

내 레포인가요? README에 깃밥 배지 달기
[![깃밥](https://www.gitbap.com/badge/mobile-next/mobile-mcp.svg)](https://www.gitbap.com/r/mobile-next/mobile-mcp)
🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법

깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.

방법 ① 커넥터 URL

클로드 설정 → 커넥터에 이 주소를 붙여넣기.

https://www.gitbap.com/api/mcp
방법 ② 플러그인 (체험까지)

플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
연결 방법 자세히 →

AI가 README 기반으로 요약했습니다 · 원문 보기