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項目，使得這個工具得以實現。特別鳴謝開源社區的所有貢獻者。