프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 30분마다 동기화해요. Google로 로그인하면 리뷰를 쓸 수 있어요.프로토타입 · 30분마다 업데이트
PopNx MCPAI를 쓰는 사람을 위한 MCP 서버 · 쉬운 말로 설명해요

iphone-cli (iph)

제작자: HyunSeob버전 0.1.8i★ 109i내 컴퓨터에서 실행공식 사이트 ↗
레지스트리 이름io.github.HyunSeob/iphone-cli

설치 방법

What it does

Control any app on a real iPhone (iOS 27+) via accessibility tree. No Xcode or WebDriverAgent.

  • Connects 내 컴퓨터에서 실행
  • Account or key No key needed
  • Category 개발자 도구

함께 쓰기

이런 작업을 AI에게 가르치는 Skill, 이것과 함께 쓸 수 있습니다

rea

Reverse engineer anything with agents, from app behavior down to native binaries.

제작자: morluto★ 468,733skill 1개

Skill · 안내서

andrej-karpathy-skills

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

제작자: multica-ai★ 234,332skill 1개

Skill · 안내서라이선스 명시 없음

graphify

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

제작자: Graphify-Labs★ 150,287skill 1개

Skill · 안내서

이 순위인 이유

목록은 사용 점수(100점 만점)로 정렬되며 구성은 다음과 같습니다

인기24/80GitHub 별 또는 주간 다운로드: 큰 쪽 60, 작은 쪽 20
최신성12/1230일 안에 릴리스나 코드 변경이 있으면 만점
응답 중0/8마지막 점검 때 클라우드 엔드포인트가 응답
사용 점수36/100

품질: 기본 점검 3/3개 통과(표시만, 정렬에는 안 씀) · 상승세: 데이터 없음 (급상승 탭에서만 사용)

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

검사 3/3 통과 · 내 컴퓨터에서 실행돼요

먼저: 어떤 AI를 쓰시나요?

쓰는 앱을 고르면 아래에 단계가 나옵니다.

Claude는 아직 iphone-cli (iph)에 연결할 수 없어요

제작자가 아직 MCP 레지스트리에 설치 방법을 올리지 않았어요

ChatGPT는 아직 iphone-cli (iph)에 연결할 수 없어요

제작자가 아직 MCP 레지스트리에 설치 방법을 올리지 않았어요

대신 이렇게 할 수 있어요

B · 개발자 도구에서 ChatGPT에 연결되는 다른 서버

같은 분류에서 많이 쓰는 것 중 키 없이 주소만으로 연결되는 것을 골랐어요

Claude Code는 아직 iphone-cli (iph)에 연결할 수 없어요

제작자가 아직 MCP 레지스트리에 설치 방법을 올리지 않았어요

Cursor는 아직 iphone-cli (iph)에 연결할 수 없어요

제작자가 아직 MCP 레지스트리에 설치 방법을 올리지 않았어요

VS Code는 아직 iphone-cli (iph)에 연결할 수 없어요

제작자가 아직 MCP 레지스트리에 설치 방법을 올리지 않았어요

Windsurf, Zed, Gemini CLI 같은 다른 MCP 앱은 추가 방법이 저마다 달라요. 앱 목록에서 확인하세요

MCP를 쓰는 앱 모두 보기 →

JSON 설정은 아래 “개발자용”에 있어요

막혔나요? iphone-cli (iph)을 쓰는 사람에게 물어보세요💬 토론 →

한눈에 보기

주간 다운로드i
npm/PyPI에 없음
연결 방식
내 컴퓨터에서 실행
최신 버전i
0.1.8
카테고리i
개발자 도구
레지스트리 공개i
2026년 11월 19일
코드 마지막 변경i
2026년 11월 19일
제작자
HyunSeob
패키지
cargo: iphone-cli
웹사이트
hyunseob.github.io
레지스트리 상태
활성

어떤 앱에서 쓸 수 있나요

이 서버의 연결 방식과 각 앱의 공식 문서를 바탕으로 했어요. 2026년 11월 10일 확인.

내 컴퓨터에서 실행하는 앱

GooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

모든 앱과 장단점 →

할 수 있는 일

내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 19일 점검

  • ✓ 통과

    제작자와 저장소 일치

    레지스트리 이름이 GitHub 계정 HyunSeob 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요

  • ✓ 통과

    계속 관리되고 있음

    코드 마지막 변경: 오늘

  • ✓ 통과

    라이선스 있음

    MIT 사용

  • – 해당 없음

    엔드포인트 응답

    내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요

  • – 해당 없음

    OAuth로 로그인

    내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요

  • … 아직 점검 안 함

    도구 설명에 숨겨진 지시 없음

    내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요

공개된 취약점 (OSV.dev)

확인 안 함: 버전이 있는 npm과 PyPI 패키지만 확인할 수 있습니다

우리가 확인하는 것 → · JSON

제작자: 재확인 요청 또는 잘못된 정보 신고
제작자용: README에 배지 달기

제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/hyunseob-iphone-cli.svg)](https://mcp.popnx.com/en/servers/hyunseob-iphone-cli)

토론

질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.

아직 글이 없어요. 처음으로 질문하거나 공유해 보세요.

이곳의 글은 사용자가 쓴 것으로, PopNx 팀의 글이 아니에요.

로그인하고 글쓰기

사용자 리뷰

아직 리뷰가 없어요

로그인하고 리뷰 쓰기

개발자 도구 카테고리의 다른 서버와 비교i

  • 이 카테고리의 다른 서버 6182개 중 97%보다 스타가 많아요
  • 이 카테고리의 다른 서버 6182개 중 99%보다 최근에 레지스트리에 공개됐어요
  • 기본 점검 결과가 이 카테고리의 다른 서버 6182개 중 99%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

iphone-cli (iph), 안전한가요?

해당하는 기본 점검 3개 중 3개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 오늘 변경됐고, 최신 버전(0.1.8)은 오늘 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Rust도 있어야 해요.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise

비슷하게 동작하는 다른 것

같은 카테고리, 다른 제작자, 명령 확인 완료. 공식이 먼저, 그다음 스타 순.

카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

GitDiagram

Architecture diagrams, explanations and Mermaid source for public GitHub repositories.

제작자: ahmedkhaleel2004널리 사용됨★ 1.9만2개월 전 업데이트

클라우드에서 실행✓ 서비스 회사 · gitdiagram.comPopNx 팀이 직접 써 봄

Appllama

Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.

제작자: Appllama널리 사용됨★ 5.2천3개월 전 업데이트

클라우드에서 실행✓ 서비스 회사 · appllama.io

Omnara

Deploy durable AI agents with Omnara, an open-source managed-agent platform.

제작자: omnara-ai널리 사용됨★ 3.4천2개월 전 업데이트

클라우드에서 실행✓ 서비스 회사 · omnara.com

Repowise

Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.

제작자: repowise-dev널리 사용됨↓ 6.5천/주★ 8.2천 저장소 전체의 별6일 전 업데이트

컴퓨터 또는 클라우드✓ 서비스 회사 · repowise.dev
비슷한 항목과 비교
이 항목
iphone-cli (iph)
GitDiagramAppllamaCloudflare MCPOmnaraRepowise
실행 위치컴퓨터에 설치 필요클라우드에서 동작, 설치 불필요클라우드에서 동작, 설치 불필요클라우드에서 동작, 설치 불필요클라우드에서 동작, 설치 불필요클라우드 또는 컴퓨터 설치 모두 가능
키 필요아니요아니요아니요아니요아니요아니요
Claude에서 +로 추가아니요아니요아니요예아니요아니요
기본 점검3/34/44/44/44/45/5
라이선스MITMITMITApache-2.0Apache-2.0AGPL-3.0
가격등록 정보에 비용 없음등록 정보에 비용 없음등록 정보에 비용 없음등록 정보에 비용 없음등록 정보에 비용 없음등록 정보에 비용 없음

제작자의 README

README 열기

제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.

iphone-cli (iph)

Let AI agents read and operate any app on a real iPhone — straight from your terminal.

No Xcode. No WebDriverAgent. No app installed on the phone. 100% Rust.

  • Direct Apple developer services — connects over USB or Wi-Fi to the same accessibility and HID services Xcode uses, with no signing or test runner
  • Accessibility tree, not screenshots — reads structured UI elements cleanly, and runs multi-step flows in one call with a built-in QuickJS engine (iph script)
  • Agent-ready — CLI + MCP server (iph mcp) + safety-first outcomes (done / not_sent / unknown)
  • Single native binary (macOS & Windows) — no Python, Node.js, or Appium runtime; install one binary and target a real iPhone on iOS 27+

Website · llms.txt · crates.io · 한국어

Built on the principle of Poki (a new implementation from its documented behaviour and device experiments, with no Poki code). Device communication relies on idevice (MIT).

$ iph read --human

Settings 430x932 15 elements application "Settings" @0,0 430x932 header "Settings" @20,119.3 53.7x37 switch "Airplane Mode" = "0" @20,489.3 390x49.3 button "Wi-Fi, HomeNet" @20,538.7 390x49.3 button "General" @20,700 390x49.3 …

$ iph tap "General" {"ok":true,"outcome":"done","elapsed_ms":1752,"sent":true,"verified":true,"screen_changed":true,…}

Scope

HostmacOS, Windows 10/11 (x64)
DeviceA real iPhone, iOS 27 or later (verified on one iPhone 15 Pro Max with iOS 27.0.1 only, Korean interface). Touch and text input go through the phone's screen-sharing service (com.apple.coredevice.displayservice, new in iOS 27), so input is not expected to work on iOS 26 or earlier (not tried)
ConnectionUSB or the same LAN (the computer may use Ethernet; verified over USB and Wi-Fi on Windows)
Out of scopeSimulators, Android, Linux hosts, landscape

On Windows, doctor, reading, touch and scripts were checked with one iPhone19,4 on iOS 27.2 over USB.

Comparison with alternatives

Capabilityiphone-cli (iph)iPhone Mirroring + OCR toolsAppium / WebDriverAgentmobile-mcp
Native Accessibility TreeYes (structured JSON)No (screenshots / Vision OCR)YesPartial (WDA on real iOS)
No Xcode / No code signingYesYesNo (requires Xcode & signing)No (WDA signing on real iOS)
No app installed on iPhoneYesYesNo (installs WDA runner)No (installs WDA on real iOS)
Windows host supportYes (macOS & Windows)No (macOS 15+ only)Limited (needs macOS to build WDA)Limited on real iOS
Works in the EUYes (no Mirroring needed)No (Mirroring unavailable)YesYes
Unicode / clipboard text inputYes (paste + restore)Simulated keystrokesYesVaries
Built-in multi-step scriptingYes (embedded QuickJS)External / per-turn callsExternal SDKPer-turn MCP calls
Safety outcome contract`done` / `not_sent` / `unknown`VariesStandard exceptionsStandard tool errors
Target scopeReal iPhone, iOS 27+Real iPhone, iOS 18+ (macOS 15+)Real iOS & SimulatorsSimulators, Android, WDA iOS
  • Choose `iphone-cli` (`iph`) when you want Claude Code, Codex, or another AI agent to operate a real iPhone (iOS 27+) via the accessibility tree without Xcode or WebDriverAgent — including on Windows or in the EU.
  • Choose an iPhone Mirroring + OCR tool if your phone runs iOS 18–26 on macOS 15+ outside the EU.
  • Choose Appium / WebDriverAgent or `mobile-mcp` if you need iOS Simulators, Android, or iOS 26 and earlier with an element tree.

Install

Neither Rust nor Xcode is needed. On a Mac it is one line in Terminal (it uses only tools macOS ships: curl, tar, shasum).

curl -fsSL https://raw.githubusercontent.com/HyunSeob/iphone-cli/main/install.sh | sh

iph setup # walks through what the phone needs

It downloads the universal binary (Apple silicon and Intel) from the latest release, checks its checksum and puts it at ~/.local/bin/iph. IPH_INSTALL_DIR picks another folder and IPH_VERSION=v0.1.0 a specific version. On Windows, download iph-windows-x86_64.zip from the releases and put iph.exe in a folder on your PATH.

  • Mac: plug the phone in and tap Trust on it; that pairs it.
  • Windows: Apple's device service must be installed: the Apple Devices app from the Microsoft Store, or just the service with winget install Apple.AppleMobileDeviceSupport. Then plug the phone in and tap Trust.
  • Developer disk image: when the phone lacks it, iph doctor installs it. It uses Xcode's copy when the Mac has one, and otherwise fetches one once from the public doronz88/DeveloperDiskImage repository (about 18 MB, pinned commit and SHA-256). The iph repository contains no Apple files.

With Rust 1.88 or later, the crate on crates.io installs the same iph (building it takes a few minutes; on Windows it needs Visual Studio Build Tools (C++)):

cargo install iphone-cli      # ~/.cargo/bin/iph

Or from a checkout:

git clone https://github.com/HyunSeob/iphone-cli

cd iphone-cli cargo install --path . # ~/.cargo/bin/iph

First-time setup

iph setup runs iph doctor, says in one line what to do on the phone for each failed check, and checks again. An agent can read checks[].user_action from iph doctor (JSON) and guide the user.

CheckRequiredWhat it is
pairingyesThe Mac holds a pairing record for the phone. If not: connect by USB and tap Trust
connectionyesThe phone is visible over USB or the same Wi-Fi
developer_modeyesSettings → Privacy & Security → Developer Mode. If it is off, iph doctor makes that switch appear
developer_disk_imageyesSource of the accessibility, display and input services. When missing, iph doctor fetches and installs it (see Install)
screen_unlockedyesThe phone is unlocked. Only lockdown's word decides a lock
settings_in_frontyesSettings comes to the front (fails when something covers it). When the screen cannot be read, accessibility_tree fails instead
accessibility_treeyesScreen elements can really be read
touch_inputyesScrolls the Settings list down one step and back to see that touch lands (--no-touch-test skips it)
wifirecommendedWireless lockdown flags and the phone's usbmuxd Network entry (see below)
auto_lockrecommendedAuto-Lock → Never for long sessions
do_not_disturbinfoShown only while Do Not Disturb from iph dnd on is still on

Setup requirements and how to interpret the checks are in docs/onboarding.md (Korean).

Wi-Fi setup and troubleshooting

Pair by USB first, then keep the iPhone unlocked on the same LAN. The computer may use Ethernet. To enable wireless connections, run this while USB is attached:

iph doctor --fix-wifi

If the phone is still not discovered, register its IP below. Wireless setup details (Korean).

Notification banners take taps near the top of the screen. Banners cover the top of the screen and are not part of the accessibility tree. A tap near the top then lands on the banner and opens another app (this happened once during development). For long unattended work turn Do Not Disturb on with iph dnd on, and put it back with iph dnd off afterwards. Details: Do Not Disturb below.

Direct IP when automatic discovery fails

For a USB-trusted phone missing from discovery, use the IP shown in Settings → Wi-Fi → the network's info button:

iph devices                                      # while USB is attached: note the UDID

iph --udid connect --ip # after unplugging USB iph --udid read

The Apple device service is still required. CLI, MCP and scripts share the saved address for the selected UDID; register it again if the IP changes. Connection details (Korean).

Commands

Every command prints JSON; add --human for people. The device is chosen by --udid, then IPH_UDID, then udid in ~/.config/iph/config.toml, then the only connected phone. With several phones and none chosen, you get an error with the list.

CommandDoes
iph connect --ip Verify and save the selected paired phone's IP
iph devicesConnected phones, iOS version, connection, readiness
iph setup / iph doctorPreparation and checks
iph read [--app] [--all] [--full] [--raw] [--max-age ms]Elements on screen. --all includes off-screen ones, --full adds identifiers (about 0.5 s more), --raw attaches every numbered attribute
iph find Elements matching a selector
iph tap [--long ms] [--double]Tap the middle of an element, or a point
iph swipe [--duration ms] [--drag]Swipe. --drag slows to a stop before lifting, so nothing coasts
`iph pinch [in\out] [--scale F] [--rotate DEG] [--at selector \x,y] [--duration ms]`Two fingers. out spreads them (zoom in, scale 2), in pinches them (zoom out, scale 0.5); --scale takes 0.25 to 4, --rotate degrees (clockwise is positive). They meet in the middle of the screen or at --at. screen_changed: false is a fair answer on a screen that does not zoom
iph scroll [--until selector] [--max N]One step, or until an element shows
iph type [--clear] [--submit]Paste text into the field that has the keyboard (any language, emoji). The clipboard is put back and the field's value checked
iph key return, esc, tab, cmd+a …
iph button Hardware buttons
iph launch [--restart] [--env K=V]… [-- …] / iph appsLaunch an app, list apps. --env sets environment variables and what follows -- goes to the app as launch arguments (iph launch com.example.app --env TZ=UTC -- -AppleLanguages "(ko)"). Either one restarts a running app, since only a new process takes them; the result says restart_implied, with the arguments and the variable names (never their values)
iph screenshot [-o file]PNG capture
iph batch A JSON array of steps in one call
iph script [--arg k=v]Run JavaScript as given (- reads stdin)
iph run [--arg k=v] / iph scriptsRun a saved script, list saved scripts
iph mcp [--tools a,b]MCP server on stdio
iph dnd Turn Do Not Disturb on, put the earlier Focus back, or show the current state
iph syslog [--app app] [--process name] [--pid N] [--level L] [--after SEQ] [--grep RE] [--max N] [-o file]Capture the phone's log in memory while other commands run; read returns what is new without stopping it, stop can return the latest matching entries. See Phone log
iph stopStop the resident process for this phone
Selectors
  • A plain string is an exact label: iph tap "General"
  • label="exact", label~="contains", label/regex/
  • role=button (application, button, switch, text_field, search_field, key, tab, header, text, image, link, adjustable, other)
  • id=… matches the accessibi

앞부분만 보여 드려요. 나머지는 저장소에서 읽어 보세요