Ios Simulator MCP

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

このサーバは、iOS シミュレータとのインタラクションを可能にするモデルコンテキストプロトコル（MCP）サーバです。シミュレータに関する情報の取得、UI インタラクションの制御、UI 要素のチェックなどを通じて、iOS シミュレータとのやり取りができます。

https://github.com/user-attachments/assets/453ebe7b-cc93-4ac2-b08d-0f8ac8339ad3

🚀 クイックスタート

このサーバを使用することで、iOS シミュレータとのインタラクションが可能になります。以下のセクションで詳細な機能、設定、使用例などを説明します。

✨ 主な機能

• 現在起動している iOS シミュレータの ID を取得します。
• シミュレータの UI とのインタラクション：
  • 現在処理中のアクションを取得します。
  • 現在のアクションに関するコンテキスト情報を取得します。
  • 現在のアクションに対する応答を制御します。
• シミュレータの状態をチェックおよび変更します。
• シミュレータのパフォーマンスデータを収集および分析します。

✨ 特性

• 複数の iOS シミュレータバージョンをサポートします。
• 効率的な状態管理とコンテキスト追跡が可能です。
• 柔軟なイベント処理メカニズムを備えています。
• 詳細なログ記録とデバッグオプションがあります。

📚 ドキュメント

設定

環境変数

以下の環境変数を設定することで、MCP サーバの動作を構成できます。

💻 使用例

基本的な使用法

const { SimulatorMcpServer } = require('ios-simulator-mcp');

// サーバインスタンスを作成
const server = new SimulatorMcpServer({
  port: 3001,
  mode: 'development',
  logging: true
});

// サーバを起動
server.start().then(() => {
  console.log('サーバが起動し、ポート 3001 でリッスンしています');
}).catch(err => {
  console.error('サーバの起動時にエラーが発生しました:', err);
});

高度な使用法

const { SimulatorMcpServer } = require('ios-simulator-mcp');

// サーバインスタンスを作成して設定
const server = new SimulatorMcpServer({
  port: 3001,
  events: {
    'custom-event': (context) => {
      // カスタムイベントの処理ロジック
      console.log('カスタムイベントが検出されました:', context);
      return { status: 'handled', response: 'カスタムイベントが処理されました' };
    }
  }
});

// サーバを起動
server.start().then(() => {
  console.log('サーバが起動し、ポート 3001 でリッスンしています');
}).catch(err => {
  console.error('サーバの起動時にエラーが発生しました:', err);
});

📦 インストール

事前条件

• Node.js バージョン >= 8.0.0
• npm または yarn パッケージマネージャ
• iOS シミュレータツールチェーンがインストールおよび設定されていること

Cursor を使用したインストール

1. NPX を使用した迅速なインストール：

   npx ios-simulator-mcp --install
   

2. ローカルでのビルドとインストール（オプション）：

   git clone https://github.com/joshuayoes/ios-simulator-mcp.git
   cd ios-simulator-mcp
   npm install
   npm run build
   

Claude Code を使用したインストール

1. NPX を使用したサーバの迅速な追加：

   claude mcp add ios-simulator --command npx --args "-y,ios-simulator-mcp"
   

2. ローカルでのビルドと追加（オプション）：

   git clone https://github.com/joshuayoes/ios-simulator-mcp.git
   cd ios-simulator-mcp
   npm install
   npm run build
   claude mcp add ios-simulator --command node --args "/full/path/to/build/index.js"
   

📄 ライセンス

MIT