MCP Ios Simulator Screenshot

🚀 iOS 模擬器屏幕截圖 MCP 服務器

本項目是一個使用模型上下文協議 (MCP) 從 iOS 模擬器捕獲屏幕截圖的服務器，能夠將當前 iOS 模擬器屏幕截圖保存到指定目錄，為開發者提供便捷的截圖獲取方式。

🚀 快速開始

1. 克隆倉庫：

   git clone [倉庫地址]
   cd mcp-ios-simulator-screenshot
   

2. 安裝依賴項：

   npm install
   

3. 啟動服務器：

   node build/index.js
   

4. 使用 MCP 客戶端調用 get_screenshot 方法。

✨ 主要特性

該項目實現了一個基於 MCP 協議的服務器，可從 iOS 模擬器捕獲屏幕截圖並保存到指定目錄，支持多種參數配置，方便開發者根據需求獲取不同格式和尺寸的截圖。

📦 安裝指南

Cline 和 Roo Code

對於 Cline 和 Roo Code，基本格式如下：

{
  "mcpServers": {
    "mcp-ios-simulator-screenshot": {
      "command": "npx",
      "args": ["-y", "mcp-ios-simulator-screenshot"]
    }
  }
}

如果您克隆了倉庫，可以使用以下配置：

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

Cursor 和 Claude Desktop

對於 Cursor 和 Claude Desktop，您需要指定 --output-dir 和輸出目錄：

{
  "mcpServers": {
    "mcp-ios-simulator-screenshot": {
      "command": "npx",
      "args": [
        "mcp-ios-simulator-screenshot",
        "--output-dir",
        "/path/to/your/output/directory"
      ]
    }
  }
}

💻 使用示例

基礎用法

使用 Postman 或 curl 發送請求：

curl http://localhost:port/mcp/methods/get_screenshot

確保配置正確的參數和輸出目錄。

📚 詳細文檔

MCP 工具參數

get_screenshot

從 iOS 模擬器捕獲屏幕截圖並保存到指定目錄。

輸出格式

成功時：

{
  "success": true,
  "message": "iOS 模擬器屏幕截圖保存成功",
  "filePath": ".screenshots/simulator_2025-04-10T16-51-16-755Z.png",
  "metadata": {
    "width": 1170,
    "height": 2532,
    "format": "png",
    "size": 382946,
    "timestamp": "2025-04-10T16:51:16.755Z"
  },
  "serverConfig": {
    "commandLineArgs": {
      "outputDir": "/Users/username/Desktop" // 只在指定 --output-dir 時包含
    }
  }
}

注意：serverConfig.commandLineArgs.outputDir 字段僅在服務器啟動時指定 --output-dir 參數時包含在響應中。

失敗時：

{
  "success": false,
  "message": "捕獲 iOS 模擬器屏幕截圖失敗: [錯誤信息]",
  "error": {
    "code": "ENOENT",
    "command": "xcrun simctl io booted screenshot --type=png -",
    "stderr": "沒有匹配的設備。"
  }
}

🔧 技術細節

技術棧

• TypeScript
• MCP 協議

故障排除

• 如果無法捕獲屏幕截圖：

  • 檢查 iOS 模擬器是否正在運行
  • 檢查 Xcode 命令行工具是否已安裝
  • 檢查是否可以直接執行 xcrun simctl io booted screenshot 命令

• 如果出現權限錯誤：

  • 檢查輸出目錄是否有寫入權限

📄 許可證

[此處指定許可證信息]