Screenshot des MCP iOS-Simulators

Ein Server, der mithilfe des Model Context Protocol (MCP) Screenshots vom iOS-Simulator aufnimmt.

Überblick

Dieses Projekt implementiert einen MCP-Protokollserver, der den aktuellen Bildschirm des iOS-Simulators erfasst und in einem angegebenen Verzeichnis speichert.

Related MCP server: MCP-URL2SNAP

Aufstellen

Cline und Roo Code

Für Cline- und Roo-Code ist das grundlegende Format:

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

Wenn Sie das Repository klonen, können Sie die folgende Konfiguration verwenden:

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

Cursor, Claude Desktop

Für Cursor und Claude Desktop müssen Sie --output-dir und das Ausgabeverzeichnis angeben:

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

MCP-Tool-Parameter

get_screenshot

Erstellt einen Screenshot vom iOS-Simulator und speichert ihn im angegebenen Verzeichnis.

Ausgabeformat

Bei Erfolg:

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

Hinweis: Das Feld serverConfig.commandLineArgs.outputDir ist nur dann in der Antwort enthalten, wenn beim Starten des Servers der Parameter --output-dir angegeben wird.

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

Fehlerbehebung

• Wenn Sie keine Screenshots aufnehmen können :

  • Überprüfen Sie, ob der iOS-Simulator ausgeführt wird

  • Überprüfen Sie, ob Xcode-Befehlszeilentools installiert sind

  • Überprüfen Sie, ob der Befehl xcrun simctl io booted screenshot direkt ausgeführt werden kann

• Wenn Berechtigungsfehler auftreten :

  • Überprüfen Sie, ob Sie Schreibberechtigungen für das Ausgabeverzeichnis haben

Anforderungen

• Node.js 16.0.0 oder höher

• macOS (iOS-Simulator erforderlich)

• Xcode-Befehlszeilentools

Technologie-Stack

• Typoskript

• Node.js

• MCP SDK (@modelcontextprotocol/sdk)

Lizenz

MIT

Weitere Sprachen

• 日本語