从任何兼容MCP的AI客户端组织iPhone主屏幕。移动应用和网页剪辑，创建文件夹，重排页面，并用自然语言检查小部件相关文本布局。

无需越狱、设备监控或Apple Configurator。

中文版 README

警告： 本项目通过pymobiledevice3使用私有iOS API。兼容性可能会随着iOS更新而改变。写作前请使用预览和备份功能。

特色

• 读取应用、文件夹、网页剪辑和小部件，包括本地化名称和捆绑包ID。
• 利用设备报告的行和列将页面渲染为文本网格。
• 编辑已保存的布局或直接更改设备。
• 创建文件夹，包括多页文件夹。
• 默认在应用布局文件前预览更改。
• 拒绝未知ID、意外移除应用、超载页面和小部件位移。
• 每次写入前自动备份，并验证最终的布局和控件。
• 恢复完整备份，包含预览和新的安全备份。

要求

• macOS 内置 usbmuxd。
• 一部通过USB连接、解锁且被Mac信任的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.