Ios Simulator Automation (IDB)

🚀 MCP 服務器 - iOS 模擬器控制工具

MCP 服務器是一個基於 idb 工具的 iOS 模擬器自動化控制服務。它藉助自然語言處理技術，把用戶指令轉化為可執行的操作命令，進而實現對 iOS 模擬器的全面掌控。

🚀 快速開始

安裝依賴項

在開始使用前，請確保你已經安裝了以下工具：

• Node.js（推薦版本 14 或以上）
• idb 命令行工具

克隆倉庫

git clone https://github.com/your-repository/mcp-server-simulator-ios-idb.git
cd mcp-server-simulator-ios-idb

安裝依賴

運行下面的命令來安裝項目所需的 npm 包：

npm install

啟動服務器

使用 Node.js 執行主程序文件以啟動服務器：

node index.js

✨ 主要特性

該服務器提供了豐富的 iOS 模擬器控制功能，主要涵蓋以下幾個方面：

基本操作

1. 模擬器會話管理
   • 創建、激活和終止模擬器會話
   • 列出所有可用的 iOS 模擬器
2. 應用生命週期
   • 啟動、停止和重啟應用程序
   • 查看正在運行的應用程序
   • 分析應用性能數據
3. 文件系統操作
   • 上傳和下載文件到模擬器
   • 創建、刪除和遍歷目錄
   • 複製和移動文件
4. 進程管理
   • 列出所有運行的進程
   • 啟動和停止特定進程
   • 查看進程詳細信息

高級功能

1. 調試與日誌
2. 圖形界面操作
   • 捕獲屏幕截圖
   • 記錄屏幕視頻
   • 模擬觸摸事件
3. 權限管理
   • 請求和授予應用程序權限
   • 管理鑰匙鏈訪問
   • 監控網絡流量
4. 模擬環境

💻 使用示例

基礎用法

# 創建新的模擬器會話
curl -X POST http://localhost:3000/api/simulator/session

# 啟動應用
curl -X POST http://localhost:3000/api/app/start \
     -d '{"bundleId":"com.example.app"}'

# 捕獲截圖
curl -X GET http://localhost:3000/api/capture/screenshot

📚 詳細文檔

架構設計

核心組件

1. IDBManager
   • 負責與 iOS 模擬器進行底層通信
   • 執行 idb 工具的所有命令操作
   • 管理模擬器的生命週期和會話狀態
2. NLParser
   • 接收並解析用戶提供的自然語言指令
   • 將其轉換為結構化的命令請求
   • 支持複雜的多步驟操作
3. MCPOrchestrator
   • 協調各個組件之間的交互
   • 分發命令到相應的執行模塊
   • 處理異步操作和錯誤處理

適配器與插件

• idb CLI Adapter：支持 idb 命令行工具的所有功能
• HTTP Adapter：提供 RESTful API 接口
• WebSocket Plugin：實現即時通信能力

MCP 集成

快速上手

1. 安裝並啟動服務器
2. 配置客戶端 SDK
3. 發送命令進行測試

示例配置

const mcp = new MCPClient('ws://localhost:3001');

async function launchApp() {
    try {
        await mcp.sendCommand({
            type: 'app_launch',
            payload: { bundleId: 'com.example.app' }
        });
        console.log('應用已啟動');
    } catch (error) {
        console.error('啟動失敗:', error);
    }
}

🤝 項目貢獻

如何貢獻

1. 提交問題報告
2. 創建功能請求
3. 參與代碼審查
4. 貢獻代碼修改

貢獻者

感謝所有為該項目做出貢獻的開發者和用戶。

📄 許可證

本項目遵循 MIT 許可證，具體內容如下：

MIT License

Copyright (c) [年份] [作者姓名]

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

📞 聯繫方式

項目維護者

• 開發者: [你的名字]
  郵箱: your.email@example.com

問題反饋

歡迎通過 GitHub 提交 issue 或 pull request，與我們共同完善這個項目。