📱 MCP Server for iOS Simulator

📱 iOS Simulator 向け MCP サーバー

appium-ios-simulator を基盤とし、MCP TypeScript SDK を利用して構築された、iOS シミュレーター向け Model Context Protocol（MCP）を実装するサーバーです。

📋 概要

このプロジェクトは、iOS シミュレーターと Model Context Protocol の間をつなぎ、iOS シミュレーターのインスタンスと標準化された通信を行えるようにします。MCP プロトコルを活用し、さまざまな環境で一貫したインターフェースを実現しながら、iOS シミュレーターをプログラムから制御できます。このサーバーは stdio をトランスポート機構として使用するため、Claude Desktop やその他の MCP 対応クライアントとの連携に最適です。

🎬 デモ

Claude AI Desktop を使用して iOS シミュレーターを起動する方法を示すデモ

🏗️ アーキテクチャ

サーバーは次の 3 つの主要コンポーネントで構成されています。

1. 🔄 シミュレーター管理レイヤー - iOS シミュレーターのライフサイクルと操作を管理します
2. 🔌 MCP プロトコルの実装 - stdio トランスポートを使用し、TypeScript SDK で Model Context Protocol を実装します
3. 📊 ロガーコンポーネント - stdio トランスポートに干渉しない、ファイルベースのロギングを提供します

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  MCP Protocol   │     │     Stdio       │     │    Simulator    │
│  Implementation │◄────┤    Transport    │◄────┤   Management    │
│                 │     │                 │     │      Layer      │
└─────────────────┘     └─────────────────┘     └─────────────────┘
        ▲                                                ▲
        │                                                │
        ▼                                                ▼
┌─────────────────┐                             ┌─────────────────┐
│   MCP Client    │                             │  iOS Simulator  │
│  (e.g. Claude)  │                             │                 │
└─────────────────┘                             └─────────────────┘

✨ 機能

• 🚀 iOS シミュレーターのインスタンスを起動、停止、管理します
• 🔌 シミュレーターを起動およびシャットダウンします
• 📲 シミュレーターにアプリケーションをインストールして起動します
• 📸 シミュレーター画面のスクリーンショットを撮影します
• 👆 座標を指定してタップを実行します
• 🔄 複数のシミュレーターセッションを同時にサポートします
• 📝 コンソール出力を行わず、包括的なファイルベースのロギングを提供します
• 🛡️ エラーに強い動作を実現します

📋 前提条件

• 🟢 Node.js（v16 以降）
• 🍎 macOS（iOS シミュレーターに必要）
• 🛠️ iOS シミュレーターがインストールされた Xcode
• 📜 TypeScript 4.5 以降

🔧 インストール

Smithery 経由でインストールする

Smithery 経由で Claude Desktop 向け iOS Simulator Control Server を自動的にインストールするには、次の手順に従います。

npx -y @smithery/cli install @atom2ueki/mcp-server-ios-simulator --client claude

手動インストール

# Clone the repository
git clone https://github.com/atom2ueki/mcp-server-ios-simulator.git
cd mcp-server-ios-simulator

# Install dependencies
npm install

🐳 Docker

サーバーをGlama MCP ディレクトリやその他のコンテナホスト向けにパッケージ化できるよう、Dockerfile が用意されています。

docker build -t mcp-server-ios-simulator .
docker run --rm -i mcp-server-ios-simulator

注: iOS シミュレーターは macOS 上でのみ実行されるため、Linux コンテナは MCP プロセスをホストして stdio で応答できますが、実際のシミュレーターを操作することはできません。このコンテナは、移植性の確認や、macOS ホストと連携するリモート MCP 環境を想定しています。

⚙️ 設定

設定は src/config.ts ファイルで行います。

const config = {
  simulator: {
    defaultDevice: process.env.SIMULATOR_DEFAULT_DEVICE || 'iPhone 16',
    defaultOS: process.env.SIMULATOR_DEFAULT_OS || '18.2',
    timeout: parseInt(process.env.SIMULATOR_TIMEOUT || '30000', 10),
  }
};

環境変数を設定することで、これらの設定をカスタマイズできます。

SIMULATOR_DEFAULT_DEVICE=iPhone 16
SIMULATOR_DEFAULT_OS=18.2
SIMULATOR_TIMEOUT=30000

🚀 使用方法

🔨 サーバーのビルドと起動

# Build the project
npm run build

# Start the server
npm start

🧰 MCP ツール

このサーバーでは、iOS シミュレーターを制御するための 2 つの異なる方法を提供しています。

📱 シミュレーターの直接管理（推奨）

これらのツールはシミュレーターの UDID を直接使用するため、セッションを維持する必要はありません。

• 📋 list-available-simulators - 利用可能なすべてのシミュレーターとその UDID を一覧表示します
• ▶️ boot-simulator-by-udid - UDID を指定してシミュレーターを直接起動します
• ⏹️ shutdown-simulator-by-udid - UDID を指定してシミュレーターを直接シャットダウンします
• 📊 list-booted-simulators - 現在起動中のすべてのシミュレーターを一覧表示します

この方法が適している場合： シミュレーターを直接起動して使用し、シャットダウンするだけの場合に使用します。

📱 セッションベースの管理（上級）

これらのツールでは、カスタムセッション ID を使ってシミュレーターを追跡するセッションレイヤーを使用します。

• 📋 list-simulator-sessions - アクティブなシミュレーターセッションをすべて一覧表示します
• ➕ create-simulator-session - 新しいシミュレーターセッションを作成します
• ❌ terminate-simulator-session - セッションを終了します（シミュレーターをシャットダウンし、クリーンアップします）
• 🔄 create-and-boot-simulator - 新しいシミュレーターセッションを作成して起動します
• ▶️ boot-simulator - 既存のセッションのシミュレーターを起動します
• ⏹️ shutdown-simulator - 既存のセッションのシミュレーターをシャットダウンします

この方法を使う場面： シミュレーターのメタデータを追跡する必要がある場合、カスタム ID でシミュレーターを参照する場合、またはより高度な管理機能を使う場合です。

📲 アプリケーション管理

• 📥 install-app - シミュレーターにアプリケーションをインストールします
• 🚀 launch-app - シミュレーターでアプリケーションを起動します
• 🛑 terminate-app - 実行中のアプリケーションを終了します

🖱️ 操作ツール

• 📷 take-screenshot - シミュレーター画面のスクリーンショットを撮影します
• 👆 tap-coordinate - 指定した座標をタップします

🤖 Claude Desktop での使用例

1. このサーバーを MCP ツールとして使用するよう Claude Desktop を設定します：

   • Claude Desktop を開きます
   • 設定 > 詳細に移動します
   • 次の設定を「MCP Servers」セクションに追加します：

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

   • /path/to/your を、このリポジトリをインストールした実際のパスに置き換えます
   • 設定を保存して、Claude Desktop を再起動します

2. 提供されているツールを使って、Claude Desktop から iOS シミュレーターを直接操作します：

   UDID を直接指定する方法（推奨）：

   1. まず、Claude に利用可能なシミュレーターの一覧を表示するよう依頼します：

      "利用可能な iOS シミュレーターをすべて表示して"
      

   2. 次に、UDID を使って特定のシミュレーターを起動します：

      "UDID 5272EA61-5796-4372-86FE-3B33831D5CC1 の iOS シミュレーターを起動して"
      

   3. 終了したら、同じ UDID を使ってシャットダウンします：

      "UDID 5272EA61-5796-4372-86FE-3B33831D5CC1 のシミュレーターをシャットダウンして"
      

   多くのユースケースでは、UDID を直接指定する方法のほうがシンプルで信頼性も高くなります。

   セッションベースの方法（上級）： セッション追跡の高度な機能が必要な場合にのみ、この方法を使用してください。

   "Create a new simulator session for iPhone 16 Pro with iOS 18.2"
   "Boot the simulator for session abc-123"
   "Take a screenshot of the simulator for session abc-123"
   "Terminate the simulator session abc-123"
   

👨‍💻 開発

📁 プロジェクト構成

src/
├── simulator/       # Simulator management layer
├── mcp/             # MCP protocol implementation
├── bridge/          # Bridge component
├── utils/           # Utility functions including logger
├── config.ts        # Configuration handling
└── index.ts         # Entry point

🔨 プロジェクトのビルド

# Install development dependencies
npm install

# Run TypeScript compiler
npm run build

📜 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については、LICENSE ファイルを参照してください。

🙏 謝辞

• 📱 iOS シミュレーターの操作機能を提供する appium-ios-simulator
• 🔌 プロトコル仕様と TypeScript SDK を提供する Model Context Protocol