Ios Simulator

🚀 マルチモーダルiOSシミュレータサーバ

このツールは、idbを使用してiOSシミュレータを制御する低レベルサーバです。自然言語処理（NLP）または直接的なコマンドを通じてiOSシミュレータとの対話をサポートします。

🚀 クイックスタート

このサーバを使用することで、iOSシミュレータを自然言語または直接コマンドで制御できます。以下に、その手順を説明します。

✨ 主な機能

• 多セッションサポート: 複数のiOSシミュレータに同時に接続できます。
• 包括的なコマンドセット: idb CLIツールのすべての機能をサポートします。
• 自然言語処理: 自然言語でコマンドを発行できます（例："サファリブラウザを開く"）。
• MCP統合: Model Context Protocolと統合し、LLMのアプリケーションプラグインとして使用できます。

📦 インストール

npmを使用してインストールします。

npm install mcp-server-simulator-ios-idb

その後、サーバを起動します。

node index.js

💻 使用例

基本的な使用法

1. MCP設定への追加

プロジェクトのルートディレクトリに.envファイルを作成または更新し、以下の内容を追加します。

MCP_SERVERS=ios-simulator
IOS_SIMULATOR_SERVER_PATH=/path/to/mcp-server-simulator-ios-idb/dist/index.js

2. LLMアプリケーションでの使用

以下のコードを使用してサーバに接続します。

const result = await useMcpTool({
    serverName: "ios-simulator",
    toolName: "process-instruction",
    arguments: {
        instruction: "サファリブラウザを開く"
    }
});

高度な使用法

コマンドリスト

1. 基本制御コマンド

• シミュレータの起動

  start_simulator
  

• シミュレータの停止

  stop_simulator
  

• シミュレータの再起動

  restart_simulator
  

2. スクリーンショットと録画

• スクリーンショットの取得

  take_screenshot /path/to/output.png
  

• 録画の開始

  start_recording /path/to/output.mp4
  

• 録画の停止

  stop_recording
  

3. ログのアクセス

• システムログの取得

  get_system_logs
  

• 特定のアプリケーションのログの取得

  get_app_logs com.example.app
  

4. デバッグ機能

• デバッグセッションの開始

  start_debug com.example.app
  

• デバッグセッションの停止

  stop_debug
  

• デバッグ状態の確認

  debug_status
  

5. 一般的な操作

• 画面要素の説明

  describe_elements
  

• 指定された座標の要素の説明

  describe_point 100,200
  

• テキストの入力

  input_text "Hello World"
  

🔧 技術詳細

システムは3つの主要なコンポーネントで構成されています。

1. IDBManager: idbプロトコルを使用してiOSシミュレータと直接対話する低レベルコンポーネントです。
2. NLParser: 自然言語命令を解釈し、構造化されたコマンドに変換するコンポーネントです。
3. MCPOrchestrator: NLP解析とIDBManagerの操作を調整する中央コンポーネントです。

📄 ライセンス

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

謝辞

このツールの実現に貢献したfacebook/idbプロジェクトと、オープンソースコミュニティのすべての貢献者に感謝します。