MobAI용 MCP(모델 컨텍스트 프로토콜) 서버 — AI 기반 모바일 기기 자동화. AI 어시스턴트(Claude Code, 커서, 윈드서프, 클라인 및 기타 MCP 호환 도구)가 단일 DSL 우선 인터페이스를 통해 안드로이드 및 iOS 기기, 에뮬레이터, 시뮬레이터를 제어할 수 있게 합니다.

작동 방식

모든 장치 상호작용은 하나의 주요 도구인 **execute_dsl]**를 통해 배치됩니다. 수십 개의 세밀한 도구(탭, 스와이프, 타입 등)를 노출하는 대신, 서버는 술어, 주장, 대기, 조건부 분기와 함께 동작 시퀀스를 설명하는 JSON 스크립트를 수용합니다. 이렇게 하면 왕복 횟수가 낮게 유지되고 서버 측에서 재시도/실패 전략을 인코딩할 수 있습니다.

소수의 동반 도구 세트는 기기 검색, 스크린샷, 앱 관리, 그리고 .mob 테스트 파일 실행을 처리합니다.

선수 조건

• Node.js 18+
• 로컬에서 실행되는 MobAI 데스크톱 앱 (HTTP API on 127.0.0.1:8686)
• 연결된 안드로이드 또는 iOS 기기, 에뮬레이터 또는 시뮬레이터

설치

클로드 코드

커서

.cursor/mcp.json에 추가:

클로드 데스크탑

~/Library/Application Support/Claude/claude_desktop_config.json (macOS)에 추가:

윈드서프 / 클라인 / 기타 MCP 클라이언트

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

Screenshots

Apps

Automation