MCP Ios Simulator Screenshot

🚀 iOS シミュレータースクリーンショット MCP サーバー

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

🚀 クイックスタート

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

✨ 主な機能

• MCP プロトコルを使用して iOS シミュレーターからスクリーンショットをキャプチャします。
• キャプチャしたスクリーンショットを指定されたディレクトリに保存します。
• 画像を VGA サイズに縮小するオプションがあります。

📦 インストール

Cline と Roo Code の設定

Cline と Roo Code では、基本的な設定は以下の通りです。

{
  "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 の設定

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 ツールパラメータ

get_screenshot

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

出力形式

成功時

{
  "success": true,
  "message": "iOS シミュレーターのスクリーンショットが正常に保存されました",
  "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" // --output-dir を指定した場合のみ含まれます
    }
  }
}

注意: serverConfig.commandLineArgs.outputDir フィールドは、サーバー起動時に --output-dir パラメータを指定した場合のみレスポンスに含まれます。

失敗時

{
  "success": false,
  "message": "iOS シミュレーターのスクリーンショットのキャプチャに失敗しました: [エラーメッセージ]",
  "error": {
    "code": "ENOENT",
    "command": "xcrun simctl io booted screenshot --type=png -",
    "stderr": "一致するデバイスがありません。"
  }
}

トラブルシューティング

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

要件

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

技術スタック

• TypeScript
• MCP プロトコル

💻 使用例

基本的な使用法

1. リポジトリをクローンします。

git clone [リポジトリのURL]
cd mcp-ios-simulator-screenshot

2. 依存関係をインストールします。

npm install

3. サーバーを起動します。

node build/index.js

4. MCP クライアントを使用して get_screenshot メソッドを呼び出します。

高度な使用法

Postman または curl を使用してリクエストを送信します。

curl http://localhost:port/mcp/methods/get_screenshot

正しいパラメータと出力ディレクトリが設定されていることを確認してください。

📄 ライセンス

[ここにライセンス情報を指定]