MCP Server Ios Simulator

🚀 iOS シミュレータ MCP サーバ

このプロジェクトは、iOS シミュレータを制御および管理するための MCP（モデルコンテキストプロトコル）サーバを提供します。このサーバを通じて、シミュレータの起動、停止、アプリケーションのインストールと起動、スクリーンショットの取得、座標クリックなどの操作を実行できます。

🚀 クイックスタート

このサーバを使用することで、iOS シミュレータの管理やアプリケーションの操作が容易になります。以下の手順に沿ってセットアップしてください。

✨ 主な機能

• シミュレータ管理：

  • iOS シミュレータの起動と停止。
  • UDID またはカスタムセッション ID を使用した複数シミュレータの管理をサポート。

• アプリケーション管理：

  • シミュレータへのアプリケーションのインストール。
  • 指定されたアプリケーションの起動と終了。

• ユーザーインタラクション：

  • シミュレータのスクリーンショットを取得し、画像として保存。
  • 指定された座標位置でのクリック操作をシミュレート。

📦 インストール

前提条件

• Node.js（バージョン要求：v14.17.0 以上）
• npm（バージョン要求：6.14.0 以上）

インストール手順

# プロジェクトの依存関係をインストール
npm install

# TypeScript コードをコンパイル
npm run build

# 開発サーバを起動
npm start

📚 ドキュメント

環境変数の設定

以下の環境変数を使用して、サーバの動作をカスタマイズできます。

• PORT：サーバがリッスンするポートを設定します。デフォルト値は 3000 です。
• DEBUG：デバッグモードを有効にします。選択肢は true または false で、デフォルト値は false です。

ログ管理

設定ファイルまたは環境変数を使用して、ログ出力のレベルと形式を調整できます。詳細な設定については、config/logger.ts ファイルを参照してください。

使用方法

CLI ツールを直接使用する

1. 利用可能なすべての iOS シミュレータを一覧表示する：

   npm run list-simulators
   

2. 指定した UDID のシミュレータを起動する：

   npm run start-simulator -- --udid "5272EA61-5796-4372-86FE-3B33831D5CC1"
   

3. 指定した UDID のシミュレータを停止する：

   npm run stop-simulator -- --udid "5272EA61-5796-4372-86FE-3B33831D5CC1"
   

MCP プロトコルを介して統合する

このサーバを MCP ツールとして Claude Desktop に統合するには、以下の手順に従ってください。

1. Claude Desktop を設定する：

   • 設定 > 詳細を開く
   • "MCP サービス" に以下の設定を追加する：

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

2. MCP コマンドを使用してシミュレータを制御する：

   • 利用可能なすべての iOS シミュレータを一覧表示する
   • 指定した UDID のシミュレータを起動する
   • シミュレータのスクリーンショットを取得する
   • 指定した UDID のシミュレータを停止する

プロジェクト構造

src/
├── simulator/       # シミュレータ管理モジュール
├── app/            # アプリケーション管理モジュール
├── logger/         # ログ管理モジュール
└── server/         # HTTP サーバモジュール

開発ガイド

コードの貢献

1. コードを提出する前に、npm test を実行してユニットテストを通過させてください。
2. 新機能または修正に対応するドキュメントとテストケースを提出してください。

問題の報告

問題が発生した場合や改善提案がある場合は、GitHub リポジトリに ISSUE を作成してください。

📄 ライセンス

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

🔧 技術詳細

プロジェクトアーキテクチャ

+-------------------+     +-------------------+
|      ユーザー           |     |       管理者        |
+-------------------+     +-------------------+
          ↑                         ↓
+-------------------+     +-------------------+
|    CLI ツール         |<----->|  MCP サーバ      |
+-------------------+     +-------------------+
          ↓                         ↑
+-------------------+     +-------------------+
|   iOS シミュレータ        |     |  シミュレータ管理ライブラリ      |
+-------------------+     +-------------------+

このアーキテクチャにより、ユーザーや管理者は CLI ツールまたは MCP サーバを通じて iOS シミュレータを管理できます。