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。これと一緒に使えます
andrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
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.
この順位の理由
一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり
| 人気 | 24/80 | GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます |
|---|---|---|
| 新しさ | 12/12 | 30 日以内のリリースかコード更新で満点 |
| 応答中 | 0/8 | 前回の確認でクラウドのエンドポイントが応答 |
| 利用スコア | 36/100 |
品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)
インストール
使っているAIアプリを選んで、設定をコピーしてください。
チェック 3/3 合格 · あなたのパソコンで動きます
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude はまだ iphone-cli (iph) につなげません
提供元はまだ MCP Registry にインストール方法を載せていません
ChatGPT はまだ iphone-cli (iph) につなげません
提供元はまだ MCP Registry にインストール方法を載せていません
代わりにできること
B · 開発者ツール の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
- Sentry✓ ChatGPT
- Compiler Explorer✓ ChatGPT
- GitDiagram✓ ChatGPT
Claude Code はまだ iphone-cli (iph) につなげません
提供元はまだ MCP Registry にインストール方法を載せていません
Cursor はまだ iphone-cli (iph) につなげません
提供元はまだ MCP Registry にインストール方法を載せていません
VS Code はまだ iphone-cli (iph) につなげません
提供元はまだ MCP Registry にインストール方法を載せていません
ひと目でわかる
- 週あたりのダウンロードi
- npm/PyPIにない
- 接続方法
- パソコンで動く
- 最新バージョンi
- 0.1.8
- レジストリ公開日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でサインイン
パソコンで動き、代わりにローカルの設定を使います
- … 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/servers/hyunseob-iphone-cli)話し合い
質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
ユーザーレビュー
まだレビューはありません
開発者ツールのほかのサーバーとの比較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スターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
GitDiagram
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Appllama
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Omnara
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Repowise
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| これ iphone-cli (iph) | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| 動く場所 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドでもパソコンにインストールでも使える |
| キーが必要 | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ |
| Claude で + から追加 | いいえ | いいえ | いいえ | はい | いいえ | いいえ |
| 基本チェック | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| ライセンス | MIT | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-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
| Host | macOS, Windows 10/11 (x64) |
| Device | A 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) |
| Connection | USB or the same LAN (the computer may use Ethernet; verified over USB and Wi-Fi on Windows) |
| Out of scope | Simulators, 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
| Capability | iphone-cli (iph) | iPhone Mirroring + OCR tools | Appium / WebDriverAgent | mobile-mcp |
|---|---|---|---|---|
| Native Accessibility Tree | Yes (structured JSON) | No (screenshots / Vision OCR) | Yes | Partial (WDA on real iOS) |
| No Xcode / No code signing | Yes | Yes | No (requires Xcode & signing) | No (WDA signing on real iOS) |
| No app installed on iPhone | Yes | Yes | No (installs WDA runner) | No (installs WDA on real iOS) |
| Windows host support | Yes (macOS & Windows) | No (macOS 15+ only) | Limited (needs macOS to build WDA) | Limited on real iOS |
| Works in the EU | Yes (no Mirroring needed) | No (Mirroring unavailable) | Yes | Yes |
| Unicode / clipboard text input | Yes (paste + restore) | Simulated keystrokes | Yes | Varies |
| Built-in multi-step scripting | Yes (embedded QuickJS) | External / per-turn calls | External SDK | Per-turn MCP calls |
| Safety outcome contract | `done` / `not_sent` / `unknown` | Varies | Standard exceptions | Standard tool errors |
| Target scope | Real iPhone, iOS 27+ | Real iPhone, iOS 18+ (macOS 15+) | Real iOS & Simulators | Simulators, 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 doctorinstalls 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.
| Check | Required | What it is |
|---|---|---|
pairing | yes | The Mac holds a pairing record for the phone. If not: connect by USB and tap Trust |
connection | yes | The phone is visible over USB or the same Wi-Fi |
developer_mode | yes | Settings → Privacy & Security → Developer Mode. If it is off, iph doctor makes that switch appear |
developer_disk_image | yes | Source of the accessibility, display and input services. When missing, iph doctor fetches and installs it (see Install) |
screen_unlocked | yes | The phone is unlocked. Only lockdown's word decides a lock |
settings_in_front | yes | Settings comes to the front (fails when something covers it). When the screen cannot be read, accessibility_tree fails instead |
accessibility_tree | yes | Screen elements can really be read |
touch_input | yes | Scrolls the Settings list down one step and back to see that touch lands (--no-touch-test skips it) |
wifi | recommended | Wireless lockdown flags and the phone's usbmuxd Network entry (see below) |
auto_lock | recommended | Auto-Lock → Never for long sessions |
do_not_disturb | info | Shown 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.
| Command | Does | ||
|---|---|---|---|
iph connect --ip | Verify and save the selected paired phone's IP | ||
iph devices | Connected phones, iOS version, connection, readiness | ||
iph setup / iph doctor | Preparation 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 apps | Launch 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 scripts | Run 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 stop | Stop 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