iOS Simulator Screenshot

Captures iOS Simulator screens and saves them to a configurable output directory for verification and documentation.

typescript

2

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can run an MCP server that captures screenshots from the iOS Simulator and saves them to a directory you specify. This enables automated visual checks, testing workflows, and quick capture of the current simulator screen for documentation or QA.

How to use

To use this server, run it locally and query it from an MCP client to capture the current iOS Simulator screen. You can direct the output to a specific folder, and the server will resize the image to a practical size while preserving detail. Use this to automate visual validation steps in your iOS testing workflow.

How to install

Prerequisites you need before starting:

Install steps

# 1) Ensure you have Node.js installed (version 16 or higher).
# 2) Install the MCP server package that provides the iOS Simulator screenshot capability.
# 3) Run the server with the appropriate command.

Configuration and usage notes

The server is configured to run as a local stdio MCP server. You start it by invoking Node with the path to the built index of the iOS simulator screenshot tool.

Troubleshooting

If you run into issues capturing screenshots, verify that the iOS Simulator is running and that the required Xcode Command Line Tools are installed. Ensure you can execute the underlying screenshot command manually and that the output directory is writable.

Requirements

Node.js 16.0.0 or higher
macOS with iOS Simulator
Xcode Command Line Tools

Technology stack

TypeScript
Node.js
MCP SDK (@modelcontextprotocol/sdk)

Example configuration for the MCP server

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

Available tools

get_screenshot

Captures a screenshot from the iOS Simulator and saves it to the specified output directory, with options to resize and organize the result.