MCP iOS シミュレータのスクリーンショット

モデルコンテキストプロトコル (MCP) を使用して iOS シミュレータからスクリーンショットをキャプチャするサーバー。

概要

このプロジェクトは、iOS シミュレータの現在の画面をキャプチャし、指定されたディレクトリに保存する MCP プロトコルサーバーを実装します。

設定

インストール：

# 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

MCP クライアント構成:

次のように、サーバー情報を MCP クライアント構成ファイルに追加します。

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

環境変数

このサーバーは環境変数を使用しません。

コマンドライン引数

このサーバーはコマンドライン引数を使用しません。

詳細設定

インストール方法によるMCPクライアント構成

グローバルにインストールする場合

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

ローカルにインストールする場合

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

リポジトリからクローンする場合

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

npxを使用する場合

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

Dockerを使用する場合

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

トラブルシューティング

スクリーンショットをキャプチャできない場合:
- iOSシミュレータが実行中かどうかを確認する
- Xcodeコマンドラインツールがインストールされているかどうかを確認する
- xcrun simctl io booted screenshotコマンドを直接実行できるかどうかを確認します
権限エラーが発生した場合:
- 出力ディレクトリへの書き込み権限があるかどうかを確認してください

プロジェクト構造

./
├── 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

ツール

iosシミュレータのスクリーンショットを取得する

iOS シミュレータからスクリーンショットをキャプチャし、指定されたディレクトリに保存します。

パラメータ

パラメータ名	タイプ	説明	デフォルト値
出力ファイル名	弦	出力ファイル名	シミュレータ_[タイムスタンプ].png
出力ディレクトリ	弦	出力ディレクトリ	.スクリーンショット
サイズ変更	ブール値	画像のサイズを変更するかどうか	真実
最大幅	整数	サイズ変更の最大幅（ピクセル）	640
デバイスID	弦	シミュレータデバイスを指定します（例： `iPhone15,2` ）	起動したデバイス ( `booted` )

出力形式

成功した場合:

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

エラーの場合:

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

要件

Node.js 16.0.0以上
macOS（iOSシミュレータが必要）
Xcode コマンドラインツール

テクノロジースタック

タイプスクリプト
Node.js
MCP SDK（@modelcontextprotocol/sdk）

ライセンス

マサチューセッツ工科大学

その他の言語

日本語

MCP iOS Simulator Screenshot

Integrations