Mobai MCP

🚀 MobAI MCP Server

MobAI のためのAIベースのモバイルデバイス自動化用のMCP（Model Context Protocol）サーバーです。このサーバーにより、Cursor、Windsurf、ClineなどのAIコーディングアシスタントやその他のMCP互換ツールがAndroidおよびiOSデバイス、エミュレーター、シミュレーターを制御できます。

✨ 主な機能

• デバイス制御：Android/iOSデバイスの一覧表示、接続、管理
• UI自動化：タップ、入力、スワイプ、ネイティブアプリとのインタラクション
• Web自動化：CSSセレクタを使用したSafari/ChromeおよびWebViewの制御
• DSLバッチ実行：複数の自動化ステップを効率的に実行
• AIエージェント：複雑なタスクを完了するための自律エージェントの実行
• スクリーンショット撮影：デバイスのスクリーンショットを撮影し保存

📦 インストール

前提条件

• Node.js 18+
• ローカルで実行中の MobAIデスクトップアプリ（ポート8686でHTTP APIを提供）
• 接続されたAndroidまたはiOSデバイス（またはエミュレーター/シミュレーター）

設定

Cursor

.cursor/mcp.json に以下を追加：

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

Claude Desktop

Claude Desktopの設定ファイル（macOSでは ~/Library/Application Support/Claude/claude_desktop_config.json）に以下を追加：

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

Windsurf

WindsurfのMCP設定に以下を追加：

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

Cline / その他のMCPクライアント

クライアントのMCPサーバー設定に従って構成します。サーバーはstdioトランスポートを使用します。

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

💻 使用例

デバイスの一覧表示とスクリーンショットの撮影

list_devicesツールを使用して接続されたデバイスを確認します。
次に、デバイスIDを指定してget_screenshotを使用します。

設定アプリの自動化

execute_dslを以下の内容で使用します：
{
  "version": "0.2",
  "steps": [
    {"action": "open_app", "bundle_id": "com.apple.Preferences"},
    {"action": "delay", "duration_ms": 1000},
    {"action": "observe", "context": "native", "include": ["ui_tree"]},
    {"action": "tap", "predicate": {"text_contains": "General"}}
  ]
}

AIエージェントの実行

device_idとタスク "Open Settings and enable WiFi" を指定してrun_agentを使用します。

📚 ドキュメント

利用可能なツール

デバイス管理

• list_devices - 接続されたすべてのデバイスを一覧表示
• get_device - デバイス情報を取得
• start_bridge - デバイス上の自動化ブリッジを起動
• stop_bridge - 自動化ブリッジを停止

UI自動化

• get_screenshot - デバイスのスクリーンショットを撮影
• get_ui_tree - アクセシビリティツリーを取得（text_regexとboundsフィルタリングをサポート）
• tap - インデックスまたは座標で要素をタップ
• type_text - テキストを入力
• swipe - スワイプジェスチャを実行
• go_home - ホーム画面に移動
• launch_app - バンドルIDでアプリを起動
• list_apps - インストールされたアプリを一覧表示

DSL実行

• execute_dsl - バッチ自動化スクリプトを実行

AIエージェント

• run_agent - 複雑なタスクのための自律エージェントを実行

Web自動化

• web_list_pages - ブラウザタブ/WebViewを一覧表示
• web_navigate - URLに移動
• web_get_dom - DOMツリーを取得
• web_click - CSSセレクタで要素をクリック
• web_type - CSSセレクタで要素にテキストを入力
• web_execute_js - JavaScriptを実行

低レベル

• http_request - MobAI APIに生のHTTPリクエストを送信

利用可能なリソース

• mobai://api-reference - 完全なAPIドキュメント
• mobai://dsl-guide - DSLバッチ実行ガイド
• mobai://native-runner - ネイティブアプリ自動化ガイド
• mobai://web-runner - Web自動化ガイド

🔧 トラブルシューティング

"Connection refused" エラー

• MobAIデスクトップアプリが実行中であることを確認してください。
• APIが http://127.0.0.1:8686 で利用可能であることを確認してください。

"Bridge not running" エラー

• 自動化を行う前に start_bridge ツールを使用してください。
• iOSブリッジの起動に最大60秒かかる場合があります。

スクリーンショットが表示されない

• スクリーンショットは /tmp/mobai/screenshots/ に保存されます。
• AIツールのファイル読み取り機能を使用して表示してください。

開発

# リポジトリをクローン
git clone https://github.com/MobAI-App/mobai-mcp.git
cd mobai-mcp

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

# ビルド
npm run build

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

📄 ライセンス

Apache 2.0 - 詳細は LICENSE を参照してください。