witchan/ios-mcp

iOS MCP: MCP management tool for jailbroken iPhones, enabling developers and AI agents to inspect and control devices.

해결하는 문제

iOS MCP는 AI 에이전트(Claude, Cursor, Codex 등)가 제한된 iOS 기기(예: 제한된 iOS 기기)를 직접 제어하고 상호작용할 수 있도록 합니다. LLM 기반 에이전트와 물리적 iOS 기기 사이의 격차를 메우며, 표준화된 프로토콜을 통해 자동 테스트, 역공학, 장치 관리를 가능하게 합니다.

작동 방식

이 프로젝트는 제한된 iOS 기기에서 직접 실행되는 Model Context Protocol (MCP) 서버를 구현합니다. AI 에이전트가 기기에서 작업을 수행할 수 있도록 46개의 도구를 공개합니다. 이 도구들은 다음과 같은 기능 영역으로 분류됩니다:

  • 터치 및 입력: HID 시뮬레이션 또는 클립보드를 통해 정밀한 화면 좌표를 기반으로 탭, 스와이프, 드래그, 텍스트 입력을 시뮬레이션합니다.
  • 시스템 제어: 앱 실행, 종료, 설치, 제거, 하드웨어 버튼(홈, 전원, 볼륨) 제어, 밝기 및 볼륨과 같은 시스템 설정 조정.
  • 시각 및 접근성: 스크린샷 캡처, 화면 내 OCR 수행, 타겟 조작을 위한 UI 요소 트리 검색.
  • 시스템 접근: 파일 시스템, 시스템 로그(syslog), 임의 명령 실행을 위한 쉘에 접근.
  • 장치 정보: 장치 사양, 배터리 상태, 제한 상태 확인.

대상 사용자

iOS 13~18을 지원하는 제한된 iOS 기기를 소유하고 있으며, 모바일 장치를 AI 기반 자동화 워크플로우에 통합하고자 하는 개발자, 보안 연구자, AI 에이전트 애호가.

주요 특징

  • 포괄적인 도구 세트: 기본 터치 제스처부터 시스템 레벨 접근까지 46개의 도구를 제공.
  • 크로스 제한 지원: 루트풀, 루트리스, 루트하이드 제한을 포함한 다양한 iOS 버전에서 호환.
  • 접근성 통합: UI 요소 트리와 OCR을 사용해 에이전트가 화면을 "보며" 지능적으로 상호작용할 수 있도록.
  • 제한된 루트 접근 권한: 패키지 관리 및 시스템 설정에 필요한 제한된 루트 권한 승격 기능 제공.

관련

  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트