simctl-mcp

simctl-mcp

iOS Simulator を制御する Model Context Protocol サーバーの実装です。

設定

.cursor/mcp.json または .vscode/mcp.json：

{
  "mcpServers": {
    "simctl-mcp": {
      "command": "npx",
      "args": ["-y", "simctl-mcp"]
    }
  }
}

プロンプト

プロンプトの例：

• シミュレーターではどのような操作ができますか？
• shortcuts:// を開く
• 「設定」アプリのバンドル ID は何ですか？
• クリップボードの内容を Hello に設定する
• シミュレーターの SDK バージョンは何ですか？
• 「設定」アプリの Appium 接続文字列を生成する

使用方法

サーバーは次の 2 つのモードで起動できます。

1. STDIO モード（デフォルト）
2. HTTP サーバーモード

STDIO モード

STDIO モードでは、サーバーは標準入出力ストリームを介して通信します。

npx simctl-mcp

HTTP サーバーモード

HTTP サーバーモードでは、サーバーは指定したポートで HTTP 接続を待ち受けます。

# Start with default port (8081)
npx simctl-mcp --http

# Start with custom port using --port flag
npx simctl-mcp --http --port 3000

# Start with custom port using environment variable
PORT=3000 npx simctl-mcp --http

ツール

デバイス管理：

• 新しいシミュレーターデバイスを作成
• 既存のデバイスを削除
• デバイスを起動
• デバイスをシャットダウン
• 利用可能なすべてのデバイスを一覧表示
• 利用可能なデバイスタイプを一覧表示
• 利用可能なランタイムを一覧表示

アプリ管理：

• アプリをインストール
• アプリをアンインストール
• アプリを起動
• 実行中のアプリを終了
• アプリのコンテナパスを取得
• アプリ情報を取得
• インストール済みアプリを一覧表示

アプリの権限：

• アプリに権限を付与
• アプリの権限を取り消し
• すべてのアプリ権限をリセット

システム機能：

• シミュレーターで URL を開く
• メディアファイルを追加
• 環境変数を取得／設定
• 外観（ライト／ダークモード）を取得／設定
• シミュレートしたプッシュ通知を送信

証明書とセキュリティ：

• ルート証明書を追加
• 通常の証明書を追加
• キーチェーンをリセット

メディアとコンテンツ：

• スクリーンショットを撮影
• ペーストボードの内容（クリップボード）を取得／設定