Mobai MCP

🚀 MobAI MCP 服務器

MobAI MCP 服務器是用於 MobAI 的 MCP（模型上下文協議）服務器，可實現基於人工智能的移動設備自動化。此服務器能讓像 Cursor、Windsurf、Cline 等支持 MCP 的人工智能編碼助手控制 Android 和 iOS 設備、模擬器以及仿真器。

🚀 快速開始

要使用 MobAI MCP 服務器，你需要滿足以下前提條件：

• Node.js 18 及以上版本
• 本地運行 MobAI 桌面應用（該應用會在 8686 端口提供 HTTP API）
• 連接 Android 或 iOS 設備（或模擬器/仿真器）

✨ 主要特性

• 設備控制：列出、連接和管理 Android/iOS 設備。
• UI 自動化：點擊、輸入、滑動以及與原生應用進行交互。
• 網頁自動化：使用 CSS 選擇器控制 Safari/Chrome 瀏覽器和 WebView。
• DSL 批量執行：高效執行多個自動化步驟。
• AI 代理：運行自主代理以完成複雜任務。
• 屏幕截圖：捕獲並保存設備屏幕截圖。

📦 安裝指南

Cursor

在 .cursor/mcp.json 中添加以下內容：

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

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 服務器設置進行配置。該服務器使用標準輸入輸出傳輸。

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

💻 使用示例

列出設備並截圖

使用 list_devices 工具查看已連接的設備。
然後使用 get_screenshot 工具並指定設備 ID 進行截圖。

自動化設置應用

使用 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 代理

使用 run_agent 工具，傳入設備 ID 和任務："Open Settings and enable WiFi"

📚 詳細文檔

可用工具

設備管理

• list_devices - 列出所有已連接的設備
• get_device - 獲取設備信息
• start_bridge - 啟動設備上的自動化橋接
• stop_bridge - 停止自動化橋接

UI 自動化

• get_screenshot - 捕獲設備屏幕截圖
• get_ui_tree - 獲取可訪問性樹（支持文本正則表達式和邊界過濾）
• tap - 通過索引或座標點擊元素
• type_text - 輸入文本
• swipe - 執行滑動手勢
• go_home - 導航到主屏幕
• launch_app - 通過包 ID 啟動應用
• list_apps - 列出已安裝的應用

DSL 執行

• execute_dsl - 執行批量自動化腳本

AI 代理

• run_agent - 運行自主代理以完成複雜任務

網頁自動化

• 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 - 網頁自動化指南

與 Claude 代碼插件的比較

MCP 服務器提供了與 Claude 代碼插件相同的功能，但可與任何支持 MCP 的人工智能工具配合使用。

🔧 技術細節

故障排除

"Connection refused" 錯誤

• 確保 MobAI 桌面應用正在運行
• 檢查 API 是否可在 http://127.0.0.1:8686 訪問

"Bridge not running" 錯誤

• 在進行自動化操作前，先使用 start_bridge 工具啟動橋接
• iOS 橋接可能需要長達 60 秒才能啟動

屏幕截圖不可見

• 屏幕截圖保存到 /tmp/mobai/screenshots/ 目錄
• 使用你的人工智能工具的文件讀取功能查看截圖

開發

# 克隆倉庫
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 文件。