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 命令

• 如果出现权限错误：

  • 检查输出目录是否有写入权限

📄 许可证

[此处指定许可证信息]