MCP 服务器

MCP iOS Simulator Screenshot

一个服务器，它使用模型上下文协议 (MCP) 从 iOS 模拟器捕获屏幕截图，并将它们保存到指定的目录中。 Or, a slightly more technical translation: 一个服务器，利用模型上下文协议 (MCP) 捕获 iOS 模拟器的屏幕截图，并将其保存至指定目录。

Tools

get_ios_simulator_screenshot

Capture a screenshot from iOS Simulator

README

MCP iOS 模拟器截图

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

概述

此项目实现了一个 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"
      ]
    }
  }
}

MCP 工具参数

get_screenshot

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

参数	类型	描述	默认值
output_filename	string	输出文件名	timestamp.png
output_directory_name	string	屏幕截图的子目录名称	.screenshots
resize	boolean	是否将图像调整为近似 VGA 大小	true
max_width	integer	调整大小的最大宽度（像素）	640
device_id	string	指定一个模拟器设备	booted device

输出格式

成功时：

{
  "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 时包含
    }
  }
}

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

{
  "success": false,
  "message": "捕获 iOS 模拟器屏幕截图时出错：[错误消息]",
  "error": {
    "code": "ENOENT",
    "command": "xcrun simctl io booted screenshot --type=png -",
    "stderr": "No matching devices found."
  }
}