MA

mobai-app/mobai-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

254 stars 22 forks 品質 88 トレンド 38Apache-2.0

mobai-app/mobai-mcpは、https://github.com/mobai-app/mobai-mcp.からインポートされたMCPサーバー候補です。

概要

mobai-app/mobai-mcpは、https://github.com/mobai-app/mobai-mcp.からインポートされたMCPサーバー候補です。

概要(AI 翻訳)

MobAI向けのMCP(Model Context Protocol)サーバー — AI搭載のモバイルデバイス自動化。AIアシスタント(Claude Code、Cursor、Windsurf、Cline、その他のMCP互換ツール)が、単一のDSLファーストインターフェースを通じてAndroidおよびiOSデバイス、エミュレーター、シミュレーターを制御できます。

仕組み

すべてのデバイス操作は一つの主要なツール「execute_dsl]」を通じてバッチ処理されます。数十の細かいツール(タップ、スワイプ、タイプなど)を公開する代わりに、サーバーは述語、主張、待機、条件分岐を含む一連のアクションを記述したJSONスクリプトを受け入れます。これにより往復回数が低く、再試行や失敗戦略がサーバー側でエンコードされます。

少数の補助ツール群は、デバイス発見、スクリーンショット、アプリ管理、そして.mobテストファイルの実行を担当します。

前提条件

  • Node.js 18+
  • ローカルで動作するMobAIデスクトップアプリ(127.0.0.1:8686のHTTP API)
  • 接続されたAndroidまたはiOSデバイス、エミュレーター、またはシミュレーター

設置

クロード・コード

カーソル

.cursor/mcp.jsonに追加:

クロードデスクトップ

~/Library/Application Support/Claude/claude_desktop_config.json(macOS)に追加:

ウィンドサーフィン/クライン/その他のMCPクライアント

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

MobAI MCP Server

MCP (Model Context Protocol) server for MobAI — AI-powered mobile device automation. Lets AI assistants (Claude Code, Cursor, Windsurf, Cline, and other MCP-compatible tools) control Android and iOS devices, emulators, and simulators via a single DSL-first interface.

How it works

All device interaction is batched through one primary tool: execute_dsl. Instead of exposing dozens of fine-grained tools (tap, swipe, type…), the server accepts a JSON script describing a sequence of actions with predicates, assertions, waits, and conditional branches. This keeps round-trips low and encodes retry/failure strategies server-side.

A small set of companion tools handles device discovery, screenshots, app management, and running .mob test files.

Prerequisites

  • Node.js 18+
  • MobAI desktop app running locally (HTTP API on 127.0.0.1:8686)
  • A connected Android or iOS device, emulator, or simulator

Installation

Claude Code

claude mcp add mobai -- npx -y mobai-mcp

Cursor

Add to .cursor/mcp.json:

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

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

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

Windsurf / Cline / other MCP clients

The server speaks stdio — use your client’s generic MCP configuration:

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

Tools

Device management

Tool Description
list_devices List all connected Android and iOS devices
get_device Get details about a specific device
start_bridge Start the automation bridge on a device (required before interaction)
stop_bridge Stop the automation bridge
claim_device Claim exclusive use of a device for this session (usually optional: acting on an unclaimed device auto-claims it)
release_device Release one or all device leases held by this session

Screenshots

Tool Description
get_screenshot Fast, low-quality screenshot for LLM visual analysis (may be downscaled; response includes scale factor)
save_screenshot Full-quality PNG to disk for reporting, debugging, or sharing

Apps

Tool Description
list_apps List installed apps on the device
install_app Install an .apk or .ipa from a local file path
uninstall_app Uninstall an app by bundle ID / package name
debug_app Launch an app in debug mode and write stdout/stderr to a log file

Automation

GitHub で README 全文を見る

インストール

npx -y mobai-mcp
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

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