MCP Server Ios Simulator

🚀 iOS 模擬器 MCP 服務器

本項目提供了一個 MCP（模型上下文協議）服務器，用於控制和管理 iOS 模擬器。藉助該服務器，可實現對模擬器的啟動、關閉、應用安裝與啟動、截圖以及座標點擊等操作。

🚀 快速開始

先決條件

• Node.js（版本要求：v14.17.0 或更高）
• npm（版本要求：6.14.0 或更高）

安裝步驟

# 安裝項目依賴
npm install

# 編譯 TypeScript 代碼
npm run build

# 啟動開發服務器
npm start

✨ 主要特性

• 模擬器管理：
  • 啟動和關閉 iOS 模擬器。
  • 支持通過 UDID 或自定義會話 ID 管理多個模擬器。
• 應用程序管理：
  • 安裝應用程序到模擬器。
  • 啟動和終止指定應用程序。
• 用戶交互：
  • 截取模擬器屏幕並保存為圖片。
  • 模擬在指定座標位置的點擊操作。

📦 安裝指南

環境變量配置

通過以下環境變量自定義服務器行為：

• PORT：設置服務器監聽端口，默認值為 3000。
• DEBUG：啟用調試模式，可選值為 true 或 false，默認值為 false。

日誌管理

支持通過配置文件或環境變量調整日誌輸出級別和格式。詳細配置請參考 config/logger.ts 文件。

💻 使用示例

直接使用 CLI 工具

列出所有可用的 iOS 模擬器

npm run list-simulators

啟動指定 UDID 的模擬器

npm run start-simulator -- --udid "5272EA61-5796-4372-86FE-3B33831D5CC1"

關閉指定 UDID 的模擬器

npm run stop-simulator -- --udid "5272EA61-5796-4372-86FE-3B33831D5CC1"

通過 MCP 協議集成

將本服務器作為 MCP 工具集成到 Claude Desktop 中：

配置 Claude Desktop

• 打開設置 > 高級
• 在 "MCP 服務" 中添加如下配置：

{
    "mcpServers": {
        "simulator": {
            "command": "node",
            "args": [
                "/path/to/your/mcp-server-ios-simulator/dist/index.js"
            ]
        }
    }
}

使用 MCP 命令控制模擬器

• 列出所有可用的 iOS 模擬器
• 啟動指定 UDID 的模擬器
• 截取模擬器屏幕
• 關閉指定 UDID 的模擬器

📚 詳細文檔

項目架構

+-------------------+     +-------------------+
|      用戶           |     |       管理員        |
+-------------------+     +-------------------+
          ↑                         ↓
+-------------------+     +-------------------+
|    CLI 工具         |<----->|  MCP 服務器      |
+-------------------+     +-------------------+
          ↓                         ↑
+-------------------+     +-------------------+
|   iOS 模擬器        |     |  模擬器管理庫      |
+-------------------+     +-------------------+

項目結構

src/
├── simulator/       # 模擬器管理模塊
├── app/            # 應用程序管理模塊
├── logger/         # 日誌管理模塊
└── server/         # HTTP 服務器模塊

開發指南

貢獻代碼

1. 提交代碼前，請確保通過 npm test 進行單元測試。
2. 為新功能或修復提交相應的文檔和測試用例。

問題反饋

遇到任何問題或有改進建議，請在 GitHub 倉庫中提 ISSUE。

📄 許可證

本項目遵循 MIT 協議，詳細內容請查看 LICENSE 文件。