Repolode
leeguooooo

leeguooooo/iphone-use

MCP를 통해 AI 에이전트가 USB 또는 Wi-Fi로 실제 iPhone 화면을 읽고 탭·입력·스와이프하게 합니다.

스타
310
포크
34
열린 이슈
3
마지막 커밋
12시간 전

어떤 프로젝트인가요?

iphone-use는 AI 에이전트가 실제 iPhone을 조작할 수 있게 해주는 셀프 호스팅 도구입니다. macOS에서 실행되는 데몬이 화면을 픽셀이 아닌 텍스트 형태의 접근성 트리로 읽고, 휴대폰에 설치된 작은 XCTest 러너를 통해 탭·입력·스와이프 명령을 보낸 뒤 화면이 안정될 때까지 기다렸다가 결과를 반환합니다. API를 제공하지 않는 앱을 포함해 어떤 앱에서든 작동하며, USB 또는 Wi-Fi로 제어할 수 있습니다.

에이전트는 Claude Code, Codex, Cursor, Claude Desktop 및 기타 MCP 클라이언트용 MCP 서버나 HTTP API를 통해 연결합니다. 각 작업은 실제로 적용됐는지 여부를 보고하며, 다른 요소에 가려진 요소를 탭하는 작업은 거부됩니다. 반복 작업은 모델 없이 재생할 수 있는 플로우로 저장할 수 있습니다. 같은 데몬은 브라우저 페이지와 네이티브 iOS 앱도 제공하므로 사람이 실시간 화면을 보며 직접 제어할 수 있습니다.

이 프로젝트를 사용하려면 macOS 15 이상이 설치된 Mac과 Xcode, Developer Mode가 활성화된 iOS 15 이상 iPhone이 필요합니다. 라이선스는 PolyForm Shield 1.0.0이며, 표준 오픈소스 라이선스가 아닌 소스 공개 라이선스입니다.

핵심 기능

  • 01스크린샷 없이 접근성 트리에서 화면을 텍스트로 읽습니다.
  • 02API가 없는 앱을 포함해 어떤 앱에서든 탭·입력·스와이프할 수 있습니다.
  • 03USB로 연결하거나, 초기 설정 후 암호화된 터널을 통해 Wi-Fi로 연결합니다.
  • 04Claude Code, Codex, Cursor 및 기타 MCP 클라이언트용 MCP 도구와 HTTP API를 제공합니다.
  • 05반복 작업을 모델이나 토큰 없이 재생할 수 있는 플로우로 저장합니다.
  • 06실시간 화면 보기와 수동 제어를 위한 브라우저 페이지 및 네이티브 iOS 앱을 제공합니다.

활용 사례

  • Claude Code나 Codex가 앱 데이터 읽기, 메시지 보내기 같은 여러 단계의 작업을 휴대폰에서 수행하게 합니다.
  • 실제 iPhone에서 로그인 또는 플로우 테스트를 실행하고 실패한 단계를 보고합니다.
  • 건강 또는 메모 앱처럼 API를 제공하지 않는 앱에서 데이터를 내보냅니다.
  • 에이전트와 직접 개입해야 하는 사람이 iPhone 한 대를 함께 사용합니다.

빠른 시작

  1. 1

    설치 스크립트로 Mac에 iphone-use를 설치합니다

    curl -fsSL https://raw.githubusercontent.com/leeguooooo/iphone-use/main/install.sh | sh
  2. 2

    에이전트가 사용할 준비가 되었는지 iPhone을 확인합니다

    iphone-use doctor
  3. 3

    설정을 열고 화면을 읽는 무해한 검사를 실행합니다

    iphone-use try

사용 전 알아둘 점

  • macOS 15 이상을 실행하는 Mac과 Xcode, Developer Mode가 켜진 iOS 15 이상의 iPhone이 필요합니다.
  • 최초 설정에는 USB 케이블이 필요합니다.
  • 라이선스는 PolyForm Shield 1.0.0이며 일부 상업적 사용이 제한됩니다. 사용 전에 약관을 확인하세요.

토픽

자주 묻는 질문

iphone-use은(는) 무엇인가요?
MCP를 통해 AI 에이전트가 USB 또는 Wi-Fi로 실제 iPhone 화면을 읽고 탭·입력·스와이프하게 합니다. iphone-use는 AI 에이전트가 실제 iPhone을 조작할 수 있게 해주는 셀프 호스팅 도구입니다. macOS에서 실행되는 데몬이 화면을 픽셀이 아닌 텍스트 형태의 접근성 트리로 읽고, 휴대폰에 설치된 작은 XCTest 러너를 통해 탭·입력·스와이프 명령을 보낸 뒤 화면이 안정될 때까지 기다렸다가 결과를 반환합니다. API를 제공하지 않는 앱을 포함해 어떤 앱에서든 작동하며, USB 또는 Wi-Fi로 제어할 수 있습니다.
iphone-use은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
iphone-use은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
iphone-use은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. iphone-use의 마지막 커밋은 2026년 10월 19일입니다.
iphone-use은(는) 어디에 사용할 수 있나요?
Claude Code나 Codex가 앱 데이터 읽기, 메시지 보내기 같은 여러 단계의 작업을 휴대폰에서 수행하게 합니다. 실제 iPhone에서 로그인 또는 플로우 테스트를 실행하고 실패한 단계를 보고합니다. 건강 또는 메모 앱처럼 API를 제공하지 않는 앱에서 데이터를 내보냅니다. 에이전트와 직접 개입해야 하는 사람이 iPhone 한 대를 함께 사용합니다.
iphone-use는 어떻게 설치하나요?
설치 스크립트로 Mac에 iphone-use를 설치합니다: curl -fsSL https://raw.githubusercontent.com/leeguooooo/iphone-use/main/install.sh | sh 에이전트가 사용할 준비가 되었는지 iPhone을 확인합니다: iphone-use doctor 설정을 열고 화면을 읽는 무해한 검사를 실행합니다: iphone-use try
iphone-use은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/leeguooooo/iphone-use

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

관련 프로젝트