Скриншот симулятора MCP iOS

Сервер, который делает снимки экрана из iOS Simulator с использованием протокола контекста модели (MCP).

Обзор

В этом проекте реализован сервер протокола MCP, который захватывает текущий экран iOS Simulator и сохраняет его в указанном каталоге.

Related MCP server: MCP-URL2SNAP

Настраивать

Код Клайна и Ру

Для кода Клайна и Ру базовый формат следующий:

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

Если вы клонируете репозиторий, вы можете использовать следующую конфигурацию:

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

Курсор, Клод Десктоп

Для Cursor и Claude Desktop необходимо указать --output-dir и выходной каталог:

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

Параметры инструмента MCP

получить_скриншот

Делает снимок экрана из iOS Simulator и сохраняет его в указанном каталоге.

Формат вывода

При успехе:

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

Примечание: Поле serverConfig.commandLineArgs.outputDir включается в ответ только в том случае, если при запуске сервера указан параметр --output-dir .

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

Поиск неисправностей

• Если вы не можете сделать снимок экрана :

  • Проверьте, запущен ли iOS Simulator

  • Проверьте, установлены ли инструменты командной строки Xcode.

  • Проверьте, можно ли напрямую выполнить команду xcrun simctl io booted screenshot

• Если возникают ошибки разрешений :

  • Проверьте, есть ли у вас права на запись в выходной каталог.

Требования

• Node.js 16.0.0 или выше

• macOS (требуется симулятор iOS)

• Инструменты командной строки Xcode

Технологический стек

• Машинопись

• Node.js

• MCP SDK (@modelcontextprotocol/sdk)

Лицензия

Массачусетский технологический институт

Другие языки

• 日本語