📱MCP
Codex로 iPhone을 자동으로 제어하는 iPhone-use
자연어로 명령하면 Codex가 USB로 연결된 실제 iPhone을 제어하고 화면을 실시간으로 보여주는 MCP 도구
↗ 원본 링크#Codex#iPhone#WebDriverAgent#자동화
iPhone-use란?
iPhone-use는 Codex가 USB로 연결된 실제 iPhone을 제어할 수 있게 해주는 MCP(Model Context Protocol) 플러그인입니다. 자연어로 작업을 설명하면 Codex가 자동으로 앱을 열고, 화면을 읽고, 클릭하고, 스크롤하며, 텍스트를 입력할 수 있습니다.
주요 기능
▸
자연어 제어: 복잡한 코드 없이 일상 언어로 iPhone 작업 지시
▸
실시간 화면: Codex 사이드바에서 iPhone 화면을 실시간으로 확인
▸
자동 앱 조작: 앱 실행, 클릭, 스크롤, 텍스트 입력 자동화
▸
WebDriverAgent 기반: Appium의 검증된 WDA를 사용한 안정적인 연결
설치 방법
필요한 환경
▸macOS와 Codex 데스크톱/CLI
▸완전한 Xcode 설치 (Command Line Tools만으로는 부족)
▸Apple 개발자 계정
▸USB로 연결된 iPhone
▸Python 3.9 이상
▸Node.js 20.19+ 또는 22.12+, npm 10+
Codex로 자동 설치
아래 프롬프트를 Codex에 붙여넣으면 자동으로 설치됩니다:
請帮我安装和配置 iPhone Use:
https://github.com/zhongerxin/iPhone-use
先读取仓库 README 和安装脚本，检查本机 Codex CLI、Python、Node.js、npm、
完整 Xcode，以及通过 USB 连接的 iPhone。把项目放到合适的本机目录，
运行 sh scripts/install.sh 安装插件。WebDriverAgent 설정
iPhone-use는 WebDriverAgent(WDA)를 통해 iPhone과 통신합니다. 첫 사용 시 자신의 Apple 계정으로 WDA를 서명하고 설치해야 합니다.
Codex가 자동으로 처리하지만, 다음 단계는 수동으로 진행해야 합니다:
1.Mac 신뢰 설정
2.개발자 모드 활성화
3.Apple 계정 로그인
4.iPhone 잠금 해제
프라이버시
플러그인은 익명 사용 통계를 PostHog로 전송합니다. 화면 내용, 입력 텍스트, 기기 식별 정보는 수집하지 않습니다.
통계 수집을 비활성화하려면:
bash
export IPHONE_USE_ANALYTICS=0
# 또는
export DO_NOT_TRACK=1활용 예시
▸"Instagram 앱을 열고 최신 게시물 3개의 제목을 정리해줘"
▸"메시지 앱에서 최근 대화 목록을 스크린샷으로 캡처해줘"
▸"설정에서 Wi-Fi를 켜줘"
자연어 명령만으로 복잡한 iPhone 작업을 자동화할 수 있습니다.