Mobai Mcp

Name: Mobai Mcp
Author: MobAI-App

@MobAI-App

Mobai Mcp について

MCP (Model Context Protocol) server for MobAI (https://mobai.run) - AI-powered mobile device automation. This server enables AI coding assistants like Cursor, Windsurf, Cline, and other MCP-compatible tools to control Android and iOS devices, emulators, and simulators.

#mobile-automation #ios #adnroid #testing #qa #test-automation

基本情報

カテゴリ

その他

トランスポート

stdio

公開者

MobAI-App

投稿者

MobAI

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

List all connected Android and iOS devices, emulators, and simulators

Get information about a specific device

Start the on-device bridge (accessibility service on Android, WebDriverAgent on iOS). Required before automation.

Stop the on-device bridge

Capture a screenshot from the device. Returns the file path to the saved PNG.

Get the UI accessibility tree showing all visible elements with indices for tapping

Tap an element by index (from UI tree) or coordinates

Type text on the device (tap input field first to focus)

Perform a swipe gesture

Navigate to device home screen

Launch an application by bundle ID

List installed applications on the device

Perform OCR text recognition on the current screen (iOS only). Returns detected text with screen coordinates for tapping (already adjusted for tapping).

Execute a batch of automation steps using the DSL (Domain Specific Language). This is the PREFERRED method for complex automation as it's more reliable than sequential API calls. DSL supports: observe, tap, type, toggle, swipe, scroll, open_app, navigate, wait_for, assert_*, if_exists, delay, execute_js (web) Example DSL script: { "version": "0.2", "steps": [ {"action": "observe", "context": "native", "include": ["ui_tree"]}, {"action": "tap", "predicate": {"text_contains": "Settings"}}, {"action": "delay", "duration_ms": 500}, {"action": "observe", "context": "native", "include": ["ui_tree"]} ], "on_fail": {"strategy": "retry", "max_retries": 2} }

Run an AI agent to perform a task autonomously. The agent will observe the screen, make decisions, and execute actions to complete the task.

List available web pages (browser tabs and WebViews) for web automation

Navigate to a URL in the browser

Get the DOM tree of the current web page

Click an element in the web page using CSS selector

Type text into a web element using CSS selector

Execute JavaScript in the web page context

Make a raw HTTP request to the MobAI API. Use this for advanced operations not covered by other tools. Base URL: http://127.0.0.1:8686/api/v1 Common endpoints: - GET /devices - List devices - GET /devices/{id}/screenshot - Take screenshot - GET /devices/{id}/ui-tree - Get UI tree - POST /devices/{id}/dsl/execute - Execute DSL script - POST /devices/{id}/agent/run - Run AI agent

概要

What is MobAI MCP?

MobAI MCP is a Model Context Protocol server for MobAI, an AI-powered mobile device automation platform. It enables AI coding assistants like Cursor, Windsurf, Cline, and other MCP-compatible tools to control Android and iOS devices, emulators, and simulators.

How to use MobAI MCP?

Run the server via npx -y mobai-mcp and configure it as an MCP server in your AI tool's settings. For example, in Cursor add to .cursor/mcp.json with the command and args shown above. The server uses stdio transport.

Key features of MobAI MCP

Device Control: List, connect, and manage Android/iOS devices
UI Automation: Tap, type, swipe, and interact with native apps
Web Automation: Control Safari/Chrome and WebViews with CSS selectors
DSL Batch Execution: Execute multiple automation steps efficiently
AI Agent: Run autonomous agents to complete complex tasks
Screenshot Capture: Capture and save device screenshots

Use cases of MobAI MCP

List connected devices and capture screenshots for visual inspection
Automate native apps (e.g., open Settings and navigate to General)
Run autonomous AI agents to complete multi-step tasks like enabling Wi-Fi
Perform web automation in Safari/Chrome and WebViews

FAQ from MobAI MCP

What are the prerequisites?

Node.js 18+ and the MobAI desktop app running locally on port 8686 with a connected Android or iOS device (or emulator/simulator).

How does this compare to the Claude Code Plugin?

The MCP server provides the same functionality as the Claude Code Plugin but works with any MCP-compatible AI client, offering named tools and resources instead of generic HTTP requests and markdown skills.