プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、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,7331 個の skill

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,3321 個の skill

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,2871 個の skill

Skill · 手順書

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気24/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア36/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

チェック 3/3 合格 · あなたのパソコンで動きます

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude はまだ iphone-cli (iph) につなげません

提供元はまだ MCP Registry にインストール方法を載せていません

ChatGPT はまだ iphone-cli (iph) につなげません

提供元はまだ MCP Registry にインストール方法を載せていません

代わりにできること

B · 開発者ツール の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code はまだ iphone-cli (iph) につなげません

提供元はまだ MCP Registry にインストール方法を載せていません

Cursor はまだ iphone-cli (iph) につなげません

提供元はまだ MCP Registry にインストール方法を載せていません

VS Code はまだ iphone-cli (iph) につなげません

提供元はまだ MCP Registry にインストール方法を載せていません

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?iphone-cli (iph) を使っている人に聞いてみましょう💬 ディスカッション →

ひと目でわかる

週あたりのダウンロード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でサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(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スターi3つの柱:レビュー · チェック · 利用状況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広く使われている★ 52303 か月前更新

クラウドで動く✓ 提供元 · appllama.io

Omnara

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

作者:omnara-ai広く使われている★ 34172 か月前更新

クラウドで動く✓ 提供元 · omnara.com

Repowise

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

作者:repowise-dev広く使われている↓ 6506/週★ 8180 リポジトリ全体のスター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

冒頭だけを表示しています。続きはリポジトリで読めます