MCP対応AIクライアントからiPhoneホーム画面を整理します。 アプリやウェブクリップを移動し、フォルダを作成したり、ページを並べ替えたり、ウィジェットのテキストレイアウトを自然言語で調べたりします。

脱獄、デバイスの監督、またはApple Configuratorは必要ありません。

日本語版 README

警告: このプロジェクトでは、pymobiledevice3 でプライベートな iOS API を使用します。 互換性はiOSのアップデートで変更できます。 ライティング前にプレビューとバックアップ機能を使用します。

##特徴

• アプリ、フォルダ、Webクリップ、およびウィジェットの読み込み、ローカライズされた名前とバンドルIDを含む。
• デバイスの報告された行と列を使用してテキストグリッドとしてページをレンダリングします。
• 保存されたレイアウトを編集するか、デバイスに直接変更を加える。
• 複数のページを持つフォルダを含むフォルダを作成します。
• レイアウトファイルを適用する前にデフォルトで変更をプレビューします。
• 未知のID、誤ったアプリの削除、過容量ページ、およびウィジェットの変位を再利用します。
• 書き込み前に自動的にバックアップし、その結果のレイアウトとウィジェットを確認します。
• プレビューと新鮮な安全バックアップを使用して、完全なバックアップを復元します。

要件

• macOS は組み込み [usbmuxd] で作成されます。
• MacでUSB、ロック解除、信頼関係の1つのiPhone.

ios-icon-mcp

Organize an iPhone home screen from any MCP-compatible AI client. Move apps and web clips, create folders, rearrange pages, and inspect widget-aware text layouts with natural language.

No jailbreak, device supervision, or Apple Configurator is required.

中文版 README

Warning: This project uses private iOS APIs through pymobiledevice3. Compatibility can change with iOS updates. Use the preview and backup features before writing.

Features

• Read apps, folders, web clips, and widgets, including localized names and bundle IDs.
• Render pages as text grids using the device’s reported rows and columns.
• Edit a saved layout or make a direct change on the device.
• Create folders, including folders with multiple pages.
• Preview changes by default before applying a layout file.
• Refuse unknown IDs, accidental app removal, over-capacity pages, and widget displacement.
• Back up automatically before every write and verify the resulting layout and widgets.
• Restore complete backups, with a preview and a fresh safety backup.

Requirements

• macOS with its built-in usbmuxd.
• One iPhone connected over USB, unlocked, and trusted by the Mac.
• uv, which provides the uvx command.

The MCP server needs Python 3.10 or newer; uvx handles the Python environment and dependencies.

Install

Add this to your MCP client’s configuration:

{
  "mcpServers": {
    "ios-icon": {
      "command": "uvx",
      "args": ["ios-icon-mcp"]
    }
  }
}

Restart the MCP client after changing its configuration. The first run downloads the package into an isolated environment.

To run directly from GitHub instead:

{
  "mcpServers": {
    "ios-icon": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/huangzheng2016/ios-icon-mcp",
        "ios-icon-mcp"
      ]
    }
  }
}

To upgrade the cached PyPI package, run uvx --refresh ios-icon-mcp or restart the client with that command once.

Quick start

Connect and unlock the iPhone, then ask your AI client:

• “Show my home screen as a text grid.”
• “Export every app with its name and bundle ID.”
• “Save the current layout, put my music apps in a folder, and preview the change.”
• “Move this app to page 2 without changing anything else.”

For a batch edit, the intended flow is:

1. save_layout creates a workspace snapshot.
2. move_icon, swap_icons, or create_folder edits that file.
3. apply_icon_layout previews the complete diff by default.