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.

Configuración

Instalación :

# Global installation
npm install -g mcp-ios-simulator-screenshot

# Or, install in your project
npm install mcp-ios-simulator-screenshot

# Or, clone from repository
git clone https://github.com/yorifuji/mcp-ios-simulator-screenshot.git
cd mcp-ios-simulator-screenshot
npm install
npm run build

Configuración del cliente MCP :

Agregue la información del servidor a su archivo de configuración de cliente MCP de la siguiente manera:

{
  "mcpServers": {
    "mcp-ios-simulator-screenshot": {
      "command": "mcp-ios-simulator-screenshot"
    }
  }
}

Variables de entorno

Este servidor no utiliza variables de entorno.

Argumentos de la línea de comandos

Este servidor no utiliza argumentos de línea de comandos.

Configuración avanzada

Configuración del cliente MCP por método de instalación

Cuando se instala globalmente

{
  "mcpServers": {
    "mcp-ios-simulator-screenshot": {
      "command": "mcp-ios-simulator-screenshot"
    }
  }
}

Cuando se instala localmente

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

Cuando se clona desde el repositorio

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

Al utilizar npx

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

Al usar Docker

{
  "mcpServers": {
    "mcp-ios-simulator-screenshot": {
      "command": "docker",
      "args": ["run", "-i", "mcp-ios-simulator-screenshot"]
    }
  }
}

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

Estructura del proyecto

./
├── src/
│   ├── index.ts                  # Entry point
│   ├── config.ts                 # Configuration
│   ├── types.ts                  # Type definitions
│   └── services/
│       └── screenshot-service.ts # Screenshot service
├── build/                        # Build output
├── .screenshots/                 # Default output directory
└── package.json                  # Project configuration

Herramientas

obtener captura de pantalla del simulador de iOS

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

Parámetros

Nombre del parámetro	Tipo	Descripción	Valor predeterminado
nombre_de_archivo_de_salida	cadena	Nombre del archivo de salida	simulador_[marca de tiempo].png
directorio_de_salida	cadena	Directorio de salida	.capturas de pantalla
cambiar el tamaño	booleano	Si desea cambiar el tamaño de la imagen	verdadero
ancho máximo	entero	Ancho máximo para redimensionar (píxeles)	640
id_del_dispositivo	cadena	Especifique un dispositivo simulador (por ejemplo, `iPhone15,2` )	Dispositivo arrancado ( `booted` )

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

En caso de error:

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

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

MCP iOS Simulator Screenshot

Integrations