/ 目錄 / 演練場 / Mobile MCP
● 社群 mobile-next ⚡ 即開即用

Mobile MCP

作者 mobile-next · mobile-next/mobile-mcp

一個 MCP 介面操控 iOS 和 Android 裝置、模擬器和模擬器——不需要了解 XCUITest 或 Espresso。

Mobile MCP 將各平台的行動自動化細節抽象為單一工具介面。Claude 可以在 iOS 模擬器、Android 模擬器或透過 USB/Wi-Fi 連接的真機上點擊、滑動、輸入、截圖和斷言。適用於 App QA、操作流程截圖,以及使用自然語言步驟進行除錯。

為什麼要用

核心特性

即時演示

實際使用效果

mobile-mcp.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "mobile-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "mobile-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@mobilenext/mobile-mcp@latest"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp@latest

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: Mobile MCP

只需一個 prompt,同時對 iOS 和 Android 進行冒煙測試

👤 行動 QA、沒有專屬 QA 團隊的開發者 ⏱ ~20 min intermediate

何時使用: 你剛出了一個 build,想確認兩個平台的註冊流程是否仍然正常。

前置條件
  • 已啟動模擬器xcrun simctl boot "iPhone 16"emulator -avd Pixel_7
  • 已安裝 App — 將 IPA/APK 拖入模擬器,或使用 install_app 工具
步驟
  1. 啟動 session
    Use mobile-mcp. List all available devices.✓ 已複製
    → iOS 模擬器和 Android 模擬器都列出
  2. 執行流程
    On both devices in parallel: open my app, tap "Sign Up", enter [email protected] / password123, tap Continue. Screenshot each step.✓ 已複製
    → 雙裝置截圖序列
  3. 驗證結果
    On each device, is the "Verify your email" screen visible? If not, report what you see.✓ 已複製
    → 各平台的通過/失敗結果,附有截圖佐證

結果: 2 分鐘內完成兩個平台的通過/失敗報告,附有截圖。

注意事項
  • 測試帳號被反垃圾機制鎖定 — 每次 build 使用一次性電子郵件;輪換測試帳號
搭配使用: filesystem

在 5 種裝置尺寸上生成 App Store 截圖

👤 提交 App Store 的獨立開發者 ⏱ ~25 min intermediate

何時使用: 你需要 6.5"、6.7"、5.5" 截圖,但不想手動一張張截。

前置條件
  • 各必要尺寸的模擬器 — 透過 xcrun simctl 建立相應裝置類型的模擬器
步驟
  1. 建立矩陣
    Boot iPhone 15 Pro Max, iPhone 15, iPhone SE simulators. Install my app on each.✓ 已複製
    → 三台裝置就緒且已安裝 App
  2. 截取流程
    On each device, navigate to the 5 key screens (onboarding, feed, detail, settings, upgrade). Screenshot each at full resolution.✓ 已複製
    → 依裝置儲存的截圖,檔名符合命名慣例

結果: 一次執行完成所有必要尺寸的 App Store 截圖。

注意事項
  • 截圖包含模擬器狀態列 — 使用 --status-bar-style=overridden 或後製裁剪
搭配使用: filesystem

組合

與其他 MCP 搭配,撬動十倍槓桿

mobile-mcp + filesystem

將截圖儲存到有版本的 QA 資料夾

Save every screenshot under /qa/$(date)/ with the test name.✓ 已複製
mobile-mcp + xcodebuild

在同一個流程中建置、安裝和測試

Build the iOS app via xcodebuild, install it via mobile-mcp, run the smoke test.✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
list_devices none 永遠第一步——先確認有哪些可用裝置 free
launch_app device_id, bundle_id 在裝置上開啟你的 App free
tap device_id, selector|coords 與按鈕或控制元件互動 free
type_text device_id, text: str 填入文字欄位(必須先聚焦) free
get_view_hierarchy device_id 確認畫面上有什麼元素 free
screenshot device_id, path?: str 視覺驗證 free

成本與限制

運行它的成本

API 配額
本機
每次呼叫 Token 數
視圖層級結構可達 10k+ tokens;截圖為 base64
費用
免費
提示
優先使用基於 selector 的點擊,而非傾印完整視圖層級結構,以節省 token

安全

權限、密鑰、影響範圍

最小權限: device access (physical USB requires trust dialog)
憑證儲存:
資料出站: MCP 本身不外送資料;截圖若與 LLM 共享則會流出
切勿授予: production device access with PII

故障排查

常見錯誤與修復

No devices listed

先啟動模擬器:xcrun simctl boot / emulator -avd X

驗證: `xcrun simctl list | grep Booted`
tap_at_coords misses

執行 get_view_hierarchy 並改用基於 selector 的點擊——座標在不同螢幕尺寸間會失準

Real device not trusted

iOS:設定 → 一般 → 裝置管理 → 信任。Android:啟用 USB 除錯。

替代方案

Mobile MCP 對比其他方案

替代方案何時用它替代權衡
XcodeBuildMCP你只需要 iOS 的建置和測試,不需要跨平台 UI 自動化不支援 Android;建置工具鏈更重
Appium你需要完整的 CI 級行動測試框架設定複雜得多;非 MCP 原生

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills