Captura de pantalla del simulador MCP iOS

Un servidor que captura capturas de pantalla del Simulador de iOS utilizando el Protocolo de contexto de modelo (MCP).

Descripción general

Este proyecto implementa un servidor de protocolo MCP que captura la pantalla actual del Simulador de iOS y la guarda en un directorio específico.

Related MCP server: Screeny MCP Server

Configuración

Código Cline y Roo

Para Cline y Roo Code, el formato básico es:

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

Si clona el repositorio, puede utilizar la siguiente configuración:

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

Cursor, Claude Desktop

Para Cursor y Claude Desktop, debe especificar --output-dir y el directorio de salida:

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

Parámetros de la herramienta MCP

obtener_captura_de_pantalla

Captura una captura de pantalla del Simulador de iOS y la guarda en el directorio especificado.

Formato de salida

En caso de éxito:

{
  "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
    }
  }
}

Nota: El campo serverConfig.commandLineArgs.outputDir solo se incluye en la respuesta cuando se especifica el parámetro --output-dir al iniciar el servidor.

{
  "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."
  }
}

Solución de problemas

• Si no puede capturar capturas de pantalla :

  • Comprueba si el simulador de iOS se está ejecutando

  • Compruebe si las herramientas de línea de comandos de Xcode están instaladas

  • Compruebe si el comando xcrun simctl io booted screenshot se puede ejecutar directamente

• Si ocurren errores de permiso :

  • Comprueba si tienes permisos de escritura para el directorio de salida

Requisitos

• Node.js 16.0.0 o superior

• macOS (se requiere simulador de iOS)

• Herramientas de línea de comandos de Xcode

Pila de tecnología

• Mecanografiado

• Node.js

• Kit de desarrollo de software de MCP (@modelcontextprotocol/sdk)

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Otros idiomas

• Japonés