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

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.

Parámetro	Tipo	Descripción	Valor predeterminado
nombre_de_archivo_de_salida	cadena	Nombre del archivo de salida	marca de tiempo.png
nombre_del_directorio_de_salida	cadena	Nombre del subdirectorio para capturas de pantalla	.capturas de pantalla
cambiar el tamaño	booleano	Si desea cambiar el tamaño de la imagen a aproximadamente tamaño VGA	verdadero
ancho máximo	entero	Ancho máximo para redimensionar (píxeles)	640
id_del_dispositivo	cadena	Especificar un dispositivo simulador	dispositivo arrancado

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

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

get_ios_simulator_screenshot

Un servidor que captura capturas de pantalla del Simulador de iOS utilizando el Protocolo de contexto de modelo (MCP) y las guarda en un directorio específico.

Related Resources

Reddit Discussion about this server

Related MCP Servers

simulator-mcp-server
JoshuaRileyDev
-
security
F
license
-
quality
An MCP server to control iOS Simulators.
Last updated -
41
22
JavaScript
AI Vision Debug MCP Server
samihalawa
A
security
A
license
A
quality
A Model Context Protocol server that provides AI vision capabilities for analyzing UI screenshots, offering tools for screen analysis, file operations, and UI/UX report generation.
Last updated -
26
1
JavaScript
ISC License
ScreenshotOne MCP Serverofficial
screenshotone
A
security
A
license
A
quality
An official MCP server implementation that allows AI assistants to capture website screenshots through the ScreenshotOne API, enabling visual context from web pages during conversations.
Last updated -
1
6
TypeScript
MIT License
MCP-URL2SNAP
Abhi5h3k
-
security
F
license
-
quality
A lightweight Model Context Protocol (MCP) server that enables your LLM to capture screenshots of any specified URL and return only the access URL for the captured image. This tool simplifies the process of generating and sharing webpage snapshots, making it perfect for integrating visual capture ca
Last updated -
1
Python

View all related MCP servers

MCP iOS Simulator Screenshot