Repolode
제출하기
jfarcand

jfarcand/mirroir-mcp

macOS의 iPhone Mirroring으로 일반 iPhone을 제어하는 MCP 서버로, Developer Mode, Xcode, WebDriverAgent가 필요 없습니다.

GitHub에서 보기웹사이트
스타
281
포크
38
열린 이슈
3
마지막 커밋
9시간 전

어떤 프로젝트인가요?

mirroir-mcp는 Apple의 iPhone Mirroring 기능을 통해 개조되지 않은 실제 iPhone을 제어하는 macOS용 MCP 서버입니다. AI 클라이언트는 OCR이나 비전으로 화면을 확인한 뒤 탭, 스와이프, 텍스트 입력, 시스템 키 입력을 수행할 수 있습니다. 휴대폰 자체 화면을 사용하므로, 사용자가 직접 빌드하거나 계측할 수 없는 App Store 앱에도 접근할 수 있습니다.

기본 제어 흐름 외에도 탐색, 스크롤, 앱 라이프사이클을 위한 상위 수준 도구를 제공합니다. 에이전트는 앱을 너비 우선으로 탐색하고 SKILL.md 워크플로를 생성할 수 있습니다. 생성한 스킬은 `mirroir test` CLI를 통해 LLM 없이 재생할 수 있으며, JUnit 출력과 CI에서 사용할 수 있는 별도의 드리프트 판정도 제공합니다.

프로젝트에는 iPhone 단계와 웹(Playwright), HTTP, 서브프로세스 단계를 하나의 시나리오에서 조합하는 Rust 러너 `mirroir-run`도 포함되어 있습니다. iOS 단계는 iPhone Mirroring이 연결된 Mac이 필요하며, 나머지 실행 환경은 Linux에서도 작동합니다.

핵심 기능

  • 01iPhone Mirroring을 통해 일반 iPhone을 제어하며 탭, 스와이프, 텍스트 입력, 키 입력을 수행합니다.
  • 02Apple Vision OCR, 선택적 YOLO 아이콘 탐지 또는 AI 비전 모드로 화면을 읽습니다.
  • 0338개의 도구를 제공하며 어떤 MCP 클라이언트와도 사용할 수 있습니다.
  • 04앱을 탐색하고 재생 가능한 SKILL.md 스킬을 생성합니다.
  • 05컴파일된 스킬을 CLI에서 LLM 없이 재생하고 JUnit 리포트를 생성합니다.
  • 06기본적으로 안전하지 않은 동작은 차단하며, 권한 설정과 차단 앱 목록을 제공합니다.

활용 사례

  • 계측할 수 없는 App Store 앱에서 엔드투엔드 스모크 테스트를 실행합니다.
  • AI 어시스턴트가 메시지 전송이나 캘린더 일정 생성 같은 일상적인 휴대폰 작업을 수행하도록 합니다.
  • 수동으로 진행한 앱 사용 과정을 기록한 뒤 CI 시나리오로 재생합니다.
  • 하나의 크로스 플랫폼 테스트에서 iPhone 검사와 웹페이지 검사를 함께 실행합니다.

빠른 시작

  1. 1

    npx로 서버를 설치합니다(macOS 15 이상 및 iPhone 미러링 필요)

    npx -y mirroir-mcp install
  2. 2

    첫 스크린샷을 찍을 때 macOS에서 메시지가 표시되면 화면 기록 및 손쉬운 사용 권한을 허용합니다

  3. 3

    mirroir를 Claude Code의 MCP 서버로 등록합니다

    claude mcp add --transport stdio mirroir -- npx -y mirroir-mcp

사용 전 알아둘 점

  • macOS 15 이상 및 iPhone 미러링에서만 작동하며 Android와 iOS Simulator는 지원하지 않습니다.
  • iPhone 미러링은 포인터 하나만 지원하므로 빠른 반응이나 멀티터치 조작이 필요한 게임은 이용할 수 없습니다.

포함된 컬렉션

Claude Code용 MCP 서버Claude Code 도구·스킬·플러그인오픈소스 AI 에이전트 프레임워크와 앱MCP 서버오픈소스 Mac 앱테스트 프레임워크 & 자동화 테스트 도구

토픽

#mcp#ios-automation#mobile-testing#computer-use#ai-agent#macos#test-automation#ai-testing#appium-alternative#claude-code

자주 묻는 질문

mirroir-mcp은(는) 무엇인가요?
macOS의 iPhone Mirroring으로 일반 iPhone을 제어하는 MCP 서버로, Developer Mode, Xcode, WebDriverAgent가 필요 없습니다. mirroir-mcp는 Apple의 iPhone Mirroring 기능을 통해 개조되지 않은 실제 iPhone을 제어하는 macOS용 MCP 서버입니다. AI 클라이언트는 OCR이나 비전으로 화면을 확인한 뒤 탭, 스와이프, 텍스트 입력, 시스템 키 입력을 수행할 수 있습니다. 휴대폰 자체 화면을 사용하므로, 사용자가 직접 빌드하거나 계측할 수 없는 App Store 앱에도 접근할 수 있습니다.
mirroir-mcp은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
mirroir-mcp은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
mirroir-mcp은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. mirroir-mcp의 마지막 커밋은 2026년 11월 6일입니다.
mirroir-mcp은(는) 어디에 사용할 수 있나요?
계측할 수 없는 App Store 앱에서 엔드투엔드 스모크 테스트를 실행합니다. AI 어시스턴트가 메시지 전송이나 캘린더 일정 생성 같은 일상적인 휴대폰 작업을 수행하도록 합니다. 수동으로 진행한 앱 사용 과정을 기록한 뒤 CI 시나리오로 재생합니다. 하나의 크로스 플랫폼 테스트에서 iPhone 검사와 웹페이지 검사를 함께 실행합니다.
mirroir-mcp는 어떻게 설치하나요?
npx로 서버를 설치합니다(macOS 15 이상 및 iPhone 미러링 필요): npx -y mirroir-mcp install 첫 스크린샷을 찍을 때 macOS에서 메시지가 표시되면 화면 기록 및 손쉬운 사용 권한을 허용합니다 mirroir를 Claude Code의 MCP 서버로 등록합니다: claude mcp add --transport stdio mirroir -- npx -y mirroir-mcp
mirroir-mcp은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/jfarcand/mirroir-mcp

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트