iPhone MCP 服务器

这是一个用于通过 Appium 自动化 iPhone 任务的 Model Context Protocol (MCP) 服务器。支持应用控制、UI 交互以及通过流式 HTTP 捕获屏幕截图。

我们推荐使用 Cherry Studio 作为 iPhone 自动化的 MCP 客户端。

功能

• 获取设备信息及列出已安装的应用程序
• 捕获屏幕截图（JPEG 格式，约 500KB）
• 列出 UI 元素并执行触摸操作
• 使用包 ID 启动或切换应用程序
• 优化 XML 输出以减少令牌使用

安装

预备条件

• Python 3.8 或更高版本
• Node.js 和 npm
• 带有 UDID 的 iPhone
• Xcode

步骤

1. 克隆仓库：git clone https://github.com/Lakr233/iphone-mcp.git && cd iphone-mcp
2. 设置虚拟环境：python -m venv .venv && source .venv/bin/activate
3. 安装依赖项：pip install -r requirements.txt
4. 安装 Appium：npm install -g appium && appium driver install xcuitest
5. 设置 WebDriver Agent：请参阅 WebDriver Agent 指南
6. 配置：编辑 start.sh 文件，填写你的 DEVICE_UDID

使用方法

运行 ./start.sh 来启动 Appium 和 MCP 服务器。默认设置下，访问 http://127.0.0.1:8765/mcp。

工具

• iphone_device_info：获取设备详情
• iphone_device_apps：列出已安装的应用程序
• iphone_interface_snapshot：捕获屏幕截图和 XML
• iphone_interface_elements：列出 UI 元素
• iphone_operate_click：执行点击
• iphone_operate_swipe：执行滑动
• iphone_operate_text_input：输入文本
• iphone_operate_app_launch：启动应用程序
• iphone_operate_get_current_bundle_id：获取当前包 ID

配置

在 start.sh 中设置环境变量（默认值在 src/utils.py 中）：

• DEVICE_UDID（必需）
• APPIUM_HOST/PORT
• SERVER_HOST/PORT/PATH
• LOG_LEVEL

开发

• 运行测试：pytest
• 代码风格：Python 3.8+，带有类型提示

贡献

分叉仓库，创建分支，并提交拉取请求。通过问题报告错误或提出功能建议。

许可证

MIT