MA

mobai-app/mobai-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

254 stars 22 forks Качество 88 Тренд 32Apache-2.0

mobai-app/mobai-mcp — это кандидат-сервер MCP, импортированный из https://github.com/mobai-app/mobai-mcp.

Обзор

mobai-app/mobai-mcp — это кандидат-сервер MCP, импортированный из https://github.com/mobai-app/mobai-mcp.

Обзор (машинный перевод)

Сервер MCP (Model Context Protocol) для MobAI — автоматизация мобильных устройств на базе искусственного интеллекта. Позволяет AI-ассистентам (Claude Code, Cursor, Windsurf, Cline и другие инструменты, совместимые с MCP) управлять устройствами Android и iOS, эмуляторами и симуляторами через один интерфейс, связанный с DSL.

Как это работает

Всё взаимодействие с устройством происходит пакетно через один основной инструмент: execute_dsl. Вместо того чтобы показывать десятки мелкозернистых инструментов (тап, свайп, ввод…), сервер принимает JSON-скрипт, описывающий последовательность действий с предикатами, утверждениями, ожиданиями и условными ветками. Это снижает количество круговых маршрутов и кодирует стратегии повтора/отказа на стороне сервера.

Небольшой набор сопутствующих инструментов занимается поиском устройств, скриншотами, управлением приложениями и запуском тестовых файлов [[T1].

Предварительные требования

  • Node.js 18+
  • Локальное десктопное приложение MobAI (HTTP API на 127.0.0.1:8686)
  • Подключённое устройство на Android или iOS, эмулятор или симулятор

Установка

Код Клода

Курсор

Добавить к [[T3]:

Клод Десктоп

Добавьте к ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

Виндсерфинг / Клайн / другие клиенты MCP

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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

Открыть полный README на GitHub

Установка

npx -y mobai-mcp
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

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