Ios Simulator

🚀 项目介绍

这个工具是一个低级别服务器，可使用idb控制iOS模拟器。它支持通过自然语言处理（NLP）或直接命令与iOS模拟器进行交互，为iOS模拟器的操作提供了更便捷的方式。

🚀 快速开始

本工具使用简单，可通过npm进行安装，安装完成后即可运行服务器，随后可将其添加到MCP配置并在LLM应用中使用。

✨ 主要特性

• 多会话支持：可以同时连接多个iOS模拟器，满足多设备测试等场景需求。
• 全面指令集：支持所有idb CLI工具的功能，功能丰富强大。
• 自然语言处理：支持通过自然语言发布命令（例如："打开 safari 浏览器"），操作更人性化。
• MCP集成：可以与Model Context Protocol集成，作为LLM的应用插件，拓展性强。

📦 安装指南

使用npm进行安装：

npm install mcp-server-simulator-ios-idb

然后运行服务器：

node index.js

💻 使用示例

基础用法

1. 添加到MCP配置

在项目的根目录下创建或更新.env文件，添加以下内容：

MCP_SERVERS=ios-simulator
IOS_SIMULATOR_SERVER_PATH=/path/to/mcp-server-simulator-ios-idb/dist/index.js

2. 在LLM应用中使用

通过以下代码连接到服务器：

const result = await useMcpTool({
    serverName: "ios-simulator",
    toolName: "process-instruction",
    arguments: {
        instruction: "打开 safari 浏览器"
    }
});

高级用法

以下为各种指令的使用示例，涵盖基本控制、截图录屏、日志访问、调试功能和常规操作等方面。

1. 基本控制命令

• 启动模拟器

start_simulator

• 停止模拟器

stop_simulator

• 重启模拟器

restart_simulator

2. 截图和录屏

• 截取屏幕

take_screenshot /path/to/output.png

• 开始录屏

start_recording /path/to/output.mp4

• 停止录屏

stop_recording

3. 访问日志

• 获取系统日志

get_system_logs

• 获取特定应用的日志

get_app_logs com.example.app

4. 调试功能

• 启动调试会话

start_debug com.example.app

• 停止调试会话

stop_debug

• 查看调试状态

debug_status

5. 常规操作

• 描述屏幕元素

describe_elements

• 描述指定坐标点的元素

describe_point 100,200

• 输入文本

input_text "Hello World"

🔧 技术细节

系统由三个主要组件组成：

1. IDBManager：直接与iOS模拟器交互的低级别组件，使用idb协议。
2. NLParser：解释自然语言指令并将其转换为结构化命令的组件。
3. MCPOrchestrator：协调NLP解析和IDBManager操作的中央组件。

📄 许可证

本项目采用MIT许可证，具体条款见LICENSE文件。

致谢

感谢facebook/idb项目，使得这个工具得以实现。特别鸣谢开源社区的所有贡献者。