MCP Connect

🚀 @plaintest/mcp-connect

AIアシスタントがiOSシミュレーターを制御し、ブラウザーを自動化できるようにするModel Context Protocol (MCP)サーバーです。xcrun simctl、fb-idb、Puppeteerの機能を1つの統合サーバーにまとめています。

✨ 主な機能

iOSシミュレーターツール

• スクリーンショット: さまざまな形式（PNG、JPEG、TIFF、BMP、GIF）でスクリーンショットを撮影できます。
• デバイス管理: シミュレーターを一覧表示し、起動中のデバイスに関する情報を取得できます。
• ジェスチャー: タップ、スワイプを時間制御で実行できます（fb-idbが必要）。
• 入力: フォーカスされたフィールドにテキストを入力し、システムボタンを押すことができます。
• ナビゲーション: URLやディープリンクを開くことができます。
• UI検査: アクセシビリティツリーを取得できます（fb-idbが必要）。
• リセット: シミュレーターを工場出荷時の設定に戻すことができます。

ブラウザー自動化ツール

• 起動と制御: Chrome/Chromiumを起動し、URLに移動できます。
• スクリーンショット: 全ページまたは特定の要素のスクリーンショットを撮影できます。
• DOM操作: 要素をクリックし、テキストを入力し、要素をクエリできます。
• 検査: DOMツリー、要素情報、ページ情報を取得できます。
• JavaScript: ページコンテキストで任意のJavaScriptを実行できます。
• Metro Bundler: React Native開発用のクイックショートカットが用意されています。

📦 インストール

オプション1: クイックインストール（推奨）

MCPクライアント用のインストーラーを実行します。

# Claude Code用
npx @plaintest/mcp-connect install claude

# Cursor用
npx @plaintest/mcp-connect install cursor

# Windsurf用
npx @plaintest/mcp-connect install windsurf

# Cline (VS Code)用
npx @plaintest/mcp-connect install cline

# GitHub Copilot (VS Code)用
npx @plaintest/mcp-connect install copilot

# すべてのクライアントに一度にインストール
npx @plaintest/mcp-connect install --all

エディターを再起動すると、ツールが使用可能になります。

オプション2: グローバルインストール

グローバルにインストールして、mcp-connectをコマンドとして使用できるようにします。

npm install -g @plaintest/mcp-connect

次に、MCPクライアントを手動で設定します。

{
  "mcpServers": {
    "mcp-connect": {
      "command": "mcp-connect"
    }
  }
}

オプション3: 手動設定

グローバルにインストールしない場合は、MCPクライアントをnpxを使用するように設定します。

{
  "mcpServers": {
    "mcp-connect": {
      "command": "npx",
      "args": ["-y", "@plaintest/mcp-connect"]
    }
  }
}

設定ファイルの場所:

• Claude Code: claude mcp addコマンドを使用します（インストール時に自動）
• Cursor: ~/.cursor/mcp.json
• Windsurf: ~/.codeium/windsurf/mcp_config.json
• Cline: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Copilot: ~/Library/Application Support/Code/User/settings.json（github.copilot.chat.experimental.mcp.serversの下）

💻 使用例

iOSシミュレーターのスクリーンショットを撮る

AI: capture_simulator_screenshotを使ってスクリーンショットを撮る

ブラウザーをナビゲートして操作する

AI: ブラウザーを起動してhttp://localhost:8081に移動する
AI: セレクターが".reload-button"の要素をクリックする
AI: スクリーンショットを撮る

iOSジェスチャー自動化

AI: 座標(200, 400)で画面をタップする
AI: 0.3秒かけて(200, 600)から(200, 200)にスワイプする
AI: フォーカスされた入力フィールドに"Hello World"を入力する

🔧 技術詳細

タップ/スワイプジェスチャーの設定

tap_screenとswipeを確実に動作させるには、fb-idbをインストールします。

brew tap facebook/fb
brew install idb-companion

fb-idbがない場合:

• タップはAppleScriptにフォールバックされます（信頼性が低い）
• スワイプは使用できません。

トラブルシューティング

Chromeが見つからない場合

Google Chromeをインストールするか、カスタムパスを設定します。

• サーバーは標準のmacOSの場所でChromeを探します。
• ChromiumとChrome Canaryもサポートされています。

シミュレーターが検出されない場合

1. Xcodeを開き、「Open Developer Tool」>「Simulator」を選択します。
2. シミュレーターを起動します。
3. xcrun simctl list devices bootedで確認します。

fb-idbが動作しない場合

# 再インストール
brew uninstall idb-companion
brew tap facebook/fb
brew install idb-companion

# 確認
which idb

ジェスチャーに対するアクセス許可が拒否された場合

アクセシビリティ許可を付与します。

1. 「システム設定」>「プライバシーとセキュリティ」>「アクセシビリティ」を開きます。
2. ターミナル（またはシェルアプリ）を追加します。
3. エディターを再起動します。

開発

# リポジトリをクローンする
git clone https://github.com/Plaintest/plaintest-mcp.git
cd plaintest-mcp

# 依存関係をインストールする
npm install

# ビルドする
npm run build

# ローカルで実行する
node dist/index.js

# ウォッチモードで実行する
npm run dev

📄 ライセンス

MITライセンス - 詳細はLICENSEを参照してください。

作者

George Al - Haddad - Plaintest