witchan/ios-mcp

中文 | English

iOS MCP는 탈옥(Jailbreak)된 iPhone에서 실행되는 MCP (Model Context Protocol) 서버로, AI 에이전트(Claude, Codex, Cursor 등)가 iOS 기기를 직접 제어할 수 있게 해줍니다.

카테고리	도구	설명
터치 제스처 (Touch Gestures)	tap_screen swipe_screen long_press double_tap drag_and_drop	정밀한 화면 좌표 조작
하드웨어 버튼	press_home press_power press_volume_up press_volume_down toggle_mute wake_and_home	HID를 통한 물리 버튼 시뮬레이션, 화면 잠금/꺼짐 상태에서 깨우기
텍스트 입력	input_text type_text press_key	클립보드 빠른 입력 / HID 한 글자씩 시뮬레이션 / 특수 키
스크린샷	screenshot get_screen_info	Base64 JPEG 스크린샷, 화면 크기 및 방향
App 관리	launch_app kill_app list_apps list_running_apps get_frontmost_app install_app uninstall_app	App 실행/종료/설치/삭제
접근성 (Accessibility)	get_ui_elements get_element_at_point	UI 노드 트리 획득, 좌표 기반 요소 조회
클립보드	get_clipboard set_clipboard	클립보드 내용 읽기/쓰기
기기 제어	get_brightness set_brightness get_volume set_volume	밝기, 볼륨
기기 정보	get_device_info	모델명, iOS 버전, 배터리, 저장 공간, 메모리, 탈옥 방식
URL	open_url	링크 또는 URL Scheme 열기
Shell	run_command	Shell 명령 실행

총 34개의 MCP 도구가 포함되어 있으며, iOS 기기 자동화의 주요 시나리오를 모두 커버합니다.

• 탈옥된 iOS 기기

탈옥 유형	지원 시스템 버전	패키지 아키텍처
rootful	iOS 13 - iOS 18	iphoneos-arm
rootless	iOS 15 - iOS 18	iphoneos-arm64
roothide	iOS 15 - iOS 18	iphoneos-arm64e

탈옥 유형에 따라 위 표의 해당 아키텍처에 맞는 .deb 패키지를 선택해 주세요.

수동 설치 시 다음 의존성을 주의하세요:

mobilesubstrate/ElleKit

preferenceloader

다음 패키지 관리자에서 직접 검색하여 설치할 수 있습니다:

Cydia

Sileo

검색 이름:

iOS MCP

• SpringBoard를 한 번 재시작하세요.

• 브라우저 접속:

• 다음 내용이 반환되면 서비스가 정상적으로 시작된 것입니다:

{"status":"ok","server":"ios-mcp","version":"1.1.0"}

설치 후 기기의 「설정」 → 「iOS MCP」로 이동하여, 서비스를 시작한 후 「MCP 프롬프트 조각 복사(Copy MCP Prompt Snippet)」를 클릭하고 이를 AI 프롬프트에 붙여넣으세요.

• MCP 서비스는 내장된 인증 기능이 없으므로, 가급적 로컬 네트워크(LAN) 환경에서만 사용하기를 권장합니다.
• 화면이 잠기거나 꺼져 있을 때, 서버 측에서는 클릭, 슬라이드, 입력, App 실행, Shell 등 상호작용/쓰기 관련 도구를 차단하며, 상태 조회, 스크린샷, 깨우기/복구 관련 도구만 허용합니다.
• run_command 도구는 임의의 Shell 명령을 실행할 수 있으므로 주의해서 사용하십시오.
• mcp-root는 root 권한 상승 기능을 제공하며, 패키지 내 도구로만 제한됩니다.

iOS MCP는 이미 많은 개발자와 사용자들이 모여 지속적으로 소통하고 있으며, 현재 여러 개의 위챗(WeChat) 교류 그룹이 개설되어 있습니다.

위챗 교류 그룹 (6번 그룹 오픈 중)	공식 계정
1번 그룹: 만석 2번 그룹: 만석 3번 그룹: 만석 4번 그룹: 만석 5번 그룹: 만석 6번 그룹: 오픈 중	移动端Android和iOS开发技术分享

6번 그룹 QR 코드가 만료된 경우, 위챗 witchan028을 추가하거나 공식 계정 移动端Android和iOS开发技术分享를 팔로우하여 최신 입장 방법을 확인하세요.

최신 소식과 입장 방법을 확인하려면 위챗을 추가하거나 공식 계정을 팔로우해 주세요.

• 위챗: witchan028
• 이메일: witchan028@126.com

witchan

본 프로젝트의 자체 코드는 MIT License를 따르며, 자세한 내용은 LICENSE를 참조하십시오.

본 프로젝트의 자체 소스 코드 및 그 중요한 부분을 사용, 수정, 배포 또는 병합할 때, 저작권 고지 및 라이선스 텍스트를 유지해야 합니다. NOTICE는 프로젝트의 출처와 면책 조항을 제공합니다.

본 프로젝트는 "AS IS" 방식으로 제공되며, 명시적 또는 암시적인 어떠한 보증도 제공하지 않습니다. 본 프로젝트의 사용, 수정, 배포, 배포 또는 실행으로 인해 발생하는 장치 이상, 데이터 손실, 서비스 중단, 계정 위험, 시스템 손상, 보안 문제, 상업적 손실 또는 기타 직접적/간접적 영향에 대해 저자는 책임을 지지 않습니다.

프로젝트에 포함된 제3자 구성 요소(예: AppSync Unified, appinst, ldid, OpenSSL, libplist, libzip)는 각자의 오픈 소스 라이선스를 따르며, 자세한 내용은 THIRD_PARTY_NOTICES.md를 참조하십시오.