MCP iOS 模拟器截图

使用模型上下文协议 (MCP) 从 iOS 模拟器捕获屏幕截图的服务器。

概述

本项目实现了一个MCP协议服务器，可以抓取iOS模拟器的当前屏幕，并保存到指定的目录。

Related MCP server: MCP-URL2SNAP

设置

克莱恩和鲁代码

对于 Cline 和 Roo 代码，基本格式是：

{
  "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，您需要指定--output-dir和输出目录：

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

MCP 工具参数

获取屏幕截图

从 iOS 模拟器捕获屏幕截图并将其保存到指定目录。

范围	类型	描述	默认值
输出文件名	细绳	输出文件名	时间戳.png
输出目录名称	细绳	屏幕截图的子目录名称	.截图
调整大小	布尔值	是否将图像调整为大约 VGA 尺寸	真的
最大宽度	整数	调整大小的最大宽度（像素）	640
设备 ID	细绳	指定模拟器设备	启动设备

输出格式

成功时：

{
  "success": true,
  "message": "iOS Simulator screenshot saved successfully",
  "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" // Only included when --output-dir is specified
    }
  }
}

注意：仅当启动服务器时指定了--output-dir参数时， serverConfig.commandLineArgs.outputDir字段才会包含在响应中。

{
  "success": false,
  "message": "Error capturing iOS Simulator screenshot: [error message]",
  "error": {
    "code": "ENOENT",
    "command": "xcrun simctl io booted screenshot --type=png -",
    "stderr": "No matching devices found."
  }
}