人工智能AI AgentMCP 服務GUI 自動化移動開發(fā)測試【免費下載鏈接】mobile-mcpModel Context Protocol Server for Mobile Automation and Scraping (iOS, Android, Emulators, Simulators and Real Devices)項目地址https://gitcode.com/GitHub_Trending/mo/mobile-mcp點擊查看免費下載test/prompt-ios-simulator.md是一份面向 LLM/Agent 的 iOS 模擬器驗收測試提示詞acceptance test prompt用于驗證 mobilecli以及其上層 mobile-mcp MCP Server能否驅動真實的 iOS 模擬器完成多應用操作 網(wǎng)頁內容檢索 截屏解釋的端到端任務。本文將完整解讀這份提示詞的輸出契約與測試任務并從源碼層面剖析其背后的工具調用鏈——從mobilecli二進制定位、devices設備枚舉到MobileDevice封裝、xcrun simctl與 WebDriverAgent 驅動路徑——讓你既能復現(xiàn)這份驗收測試也能理解 Agent 每一步操作真正落到哪一行代碼。一、提示詞的本質一份可執(zhí)行的 Agent 驗收契約test/prompt-ios-simulator.md全文 17 行是一段可以直接投喂給任意 MCP 客戶端Claude Code、Codex、Gemini、Copilot、Cursor 等的系統(tǒng)級指令。它的核心意圖不是教用戶如何使用而是用一道真實任務驗證 mobilecli 驅動 iOS 模擬器的能力是否達標。提示詞首先為 Agent 確立了嚴格的輸出紀律You are running an acceptance test for mobilecli. The output of this prompt must be a json with a simple pass boolean.這要求 Agent 的最終響應必須是唯一的 JSON 對象且滿足字段類型說明passboolean測試是否通過errorstring可選僅當測試失敗時出現(xiàn)用人類可讀語言說明問題所在stepsstring[]你為完成任務實際執(zhí)行的步驟且必須包含用到的 MCP 工具名同時給出了三條鐵律整段響應只能包含該 JSON前后不得有任何摘要、評注或 Markdown 圍欄響應的第一個字符必須是{最后一個字符必須是}。這種機器可解析 人類可讀 steps的雙重要求與 mobilecli 命令本身結構化 JSON 輸出的設計一脈相承——例如mobilecli.devices命令返回{status:ok, data:{devices:[...]}}格式見 src/mobilecli.tsAgent 與 CLI 之間始終以確定性 JSON 交換信息。test標簽內的任務描述如下原文先斷言只有一個 iOS 模擬器連接然后使用模擬器前往 Wikipedia 查詢今日文章啟動 Reminders 應用添加一條了解今日精選文章的提醒接著搜索 NASA 每日天文圖片截圖并向人類解釋照片內容。二、測試任務逐條拆解四步端到端場景1. 斷言只有一個 iOS 模擬器連接這是環(huán)境前置校驗。Agent 應當調用mobile_list_available_devices工具枚舉所有可用設備物理機、模擬器、仿真器并檢查 iOS 類型設備中state online已啟動的模擬器恰好為一個。在源碼層面該工具在 src/server.ts 注冊默認非 legacy 模式路徑下調用mobilecli.getDevices({ includeOffline: true })然后過濾出state online的設備。getDevices最終拼接為mobilecli devices [--include-offline] [--platform ...] [--type ...]子命令并解析 JSON 響應src/mobilecli.ts。值得注意的是createRobotFromDevice中還有一個隱性步驟對于 iOS 模擬器若agentStatus返回fail會自動先執(zhí)行agentInstallsrc/server.ts即首次使用前自動部署 mobilecli 的 iOS 模擬器 Agent。測試文件的對應驗證邏輯是test/iphone-simulator.ts它用mobilecli.getDevices({ platform:ios, type:simulator, includeOffline:false })取出已啟動模擬器列表并僅在 1臺時運行用例test.skip(!hasOneSimulator, ...)——可見至少/恰好一臺是 iOS 模擬器用例的通用前提t(yī)est/iphone-simulator.ts。2. 打開 Wikipedia 查詢今日文章Agent 應調用mobile_open_url打開 Wikipedia。該工具在 src/server.ts 實現(xiàn)并帶有一個重要的安全閘門默認只允許http://與https://協(xié)議只有顯式設置環(huán)境變量MOBILEMCP_ALLOW_UNSAFE_URLS1才會放行其他 URL scheme見 README.md 環(huán)境變量表。隨后 URL 經(jīng)由MobileDevice.openUrl落到mobilecli url url --device idsrc/mobile-device.ts。3. 啟動 Reminders 并添加提醒Agent 應調用mobile_launch_app啟動提醒事項應用例如 bundle idcom.apple.reminders這與test/iphone-simulator.ts中restartRemindersApp使用的包名一致見 test/iphone-simulator.ts。mobile_launch_app支持可選的locale參數(shù)逗號分隔的 BCP 47 標簽在 legacy 路徑下會轉換為simctl launch uuid bundle -AppleLanguages (...) -AppleLocale locale見 src/iphone-simulator.ts。添加提醒文本通常需要組合使用mobile_list_elements_on_screen找到New Reminder入口測試中用e.label New Reminder定位見 test/iphone-simulator.tsmobile_click_on_screen_at_coordinates或mobile_tap點擊mobile_type_keys鍵入文字可配合submit: true觸發(fā)回車提交服務端實現(xiàn)為sendKeys后補按ENTER見 src/server.ts。4. 搜索 NASA 每日圖片并截圖解釋Agent 回到瀏覽器再次mobile_open_url或直接復用網(wǎng)頁搜索 NASA 每日天文圖片APOD然后調用mobile_take_screenshot獲取當前畫面。mobile_take_screenshot在 src/server.ts 注冊默認輸出JPEG、質量 75、最大邊 1024pxDEFAULT_SCREENSHOT_MAX_SIZE 1024maxSize與scale參數(shù)可調整縮放返回時會附帶describeCoordinateMapping生成的截圖坐標 ? 屏幕坐標映射說明幫助模型把看到的像素位置換算為真實點按坐標避免因縮放導致的點擊偏差見 src/coordinate-mapping.ts 與 server.ts 中相關注釋。最后 Agent 將圖片內容結合steps一并寫入 JSON 的說明性解釋——這正是提示詞第 14 行take a screenshot to explain to me whats in the photo的意圖驗證 Agent 能否看圖說話。三、底層工具鏈mobilecli 二進制如何被發(fā)現(xiàn)與調用所有操作最終都匯聚到同一個核心依賴mobilecli——一個跨平臺、跨設備iOS/Android、模擬器/仿真器/真機的統(tǒng)一設備 CLIREADME 將其定位為Mobile MCP is built on的底層工具。src/mobilecli.ts中的Mobilecli類封裝了它的一切二進制定位getMobilecliPathsrc/mobilecli.ts優(yōu)先讀取環(huán)境變量MOBILECLI_PATH否則按process.platform/process.arch拼出作用域包名mobilecli-platform-archWindows 下追加.exearm64/amd64 歸一化依次在node_modules根目錄下的mobilecli/bin/≤1.0.6 的舊布局與mobilenext/mobilecli-*≥1.0.7 的分平臺新布局中查找。找不到時拋出Could not find mobilecli binary for platform: ...。三種執(zhí)行模式executeCommandUTF-8 文本默認 30s 超時、executeCommandBuffer二進制輸出用于截圖MAX_BUFFER_SIZE 8MB、spawnCommand異步子進程用于錄屏、日志流。版本自檢getVersion()解析mobilecli --version服務端每次創(chuàng)建設備句柄前調用ensureMobilecliAvailable()失敗即拋出ActionableError并提示查閱 wikisrc/server.ts。設備對象則由MobileDevice統(tǒng)一封裝src/mobile-device.ts所有命令統(tǒng)一追加--device id后綴并把dump ui無障礙元素樹、io tap/swipe/text/button輸入手勢、apps launch/terminate/install應用管理、device info/orientation/location設備信息等子命令翻譯為類型化方法。getElementsOnScreen會遞歸展開嵌套元素樹為扁平ScreenElement[]flattenUIElement使 Agent 拿到帶ref/rect的結構化 UI 數(shù)據(jù)——這就是Accessibility-first以無障礙樹驅動而非視覺模型架構的落地。四、iOS 模擬器的兩條驅動路徑倉庫同時存在兩代 iOS 模擬器驅動理解它們能幫你判斷提示詞實際會走哪條路默認路徑mobilecli 原生驅動createRobotFromDevice在非 legacy 模式下直接返回MobileDevice一切經(jīng)由 mobilecli 的 iOS Agent 完成。agentVerifiedSimulators集合保證同一模擬器只做一次 Agent 安裝/校驗src/server.ts。Legacy 路徑MOBILEMCP_LEGACY_ROBOT1iOS 模擬器回落到src/iphone-simulator.ts的Simctl類——它通過xcrun simctl launch/terminate/install/listapps/io screenshot直接控制模擬器并依賴WebDriverAgent端口 8100執(zhí)行截圖、點按、滑動、鍵盤輸入與元素樹導出src/iphone-simulator.ts若 WDA 未啟動會先simctl launch com.facebook.WebDriverAgentRunner.xctrunner并輪詢 10 秒等待就緒。README 的環(huán)境變量表明確說明MOBILEMCP_LEGACY_ROBOT1僅對 Android 真機與 iOS 真機啟用舊版 robotiOS 模擬器始終使用 mobilecli。因此本文提示詞場景iOS 模擬器在默認配置下走的必然是 mobilecli 路徑。五、環(huán)境準備與復現(xiàn)前提要在本機復現(xiàn)這份驗收測試需要滿足依據(jù) README.md 的 Prerequisites 與 Running 章節(jié)Xcode 命令行工具與一個已啟動的 iOS 模擬器可用xcrun simctl list查看xcrun simctl boot iPhone 16啟動。Node.js v20并通過 MCP 客戶端注冊服務標準配置為npx -y mobilenext/mobile-mcplatestmcpServersJSONClaude Code 可用claude mcp add mobile-mcp -- npx -y mobilenext/mobile-mcplatest安裝后先讓 Agent 執(zhí)行mobile_list_available_devices驗證連通。運行模式默認 stdio需要遠程服務時用--listen [host:]port啟動 Streamable HTTP如npx mobilenext/mobile-mcplatest --listen 3000并可用MOBILEMCP_AUTH設置 Bearer 鑒權見 src/index.ts 的--listen/--stdio參數(shù)解析與 README.md 的授權說明?？蛇x環(huán)境變量MOBILEMCP_DISABLE_TELEMETRY1關閉匿名遙測MOBILEMCP_ALLOW_UNSAFE_URLS1放行非 http(s) 協(xié)議本文的 Wikipedia/NASA 頁面均為 https無需設置。六、倉庫中的同類佐證測試如何驗證這些能力test/目錄下的測試用例為本文提示詞中的操作提供了直接的能力證明test/iphone-simulator.ts驗證了 iOS 模擬器上的滑動swipe up/down 后元素可見性斷言、鍵入與回車提交device.sendKeys(random) pressButton(ENTER)后用e.value斷言、屏幕尺寸scale 1恰好 3 個屬性以及截圖字節(jié)數(shù)校驗。test/ios.ts驗證真機/模擬器截圖是合法 PNG 且與getScreenSize一致Math.ceil(pngSize.width / screenSize.scale) screenSize.width并強調WDA 返回的是 point 而非 pixel這一關鍵換算關系。test/prompt-android-emulator.md姊妹篇提示詞覆蓋 Android 仿真器場景安裝/前臺斷言/保存 PNG/滑動手勢等可交叉理解 mobilecli 的平臺無關設計。scripts/verify-streamable-http.mjs驗證 HTTP 傳輸模式的可用性與--listen部署相關。如果你在運行這份驗收測試時看到失敗請檢查 JSON 中的error與steps多數(shù)失敗可歸因于三類——模擬器未啟動mobile_list_available_devices返回空、mobilecli 二進制缺失ensureMobilecliAvailable拋錯、或 WDA/Agent 未就緒legacy 路徑的ActionableError會直接提示查閱 wiki。七、小結test/prompt-ios-simulator.md雖然只有 17 行卻完整勾勒了 mobilecli 體系的能力邊界結構化 JSON 輸出契約pass/error/steps、多應用切換與網(wǎng)頁內容檢索、無障礙元素樹驅動的輸入、以及截屏 坐標映射的視覺反饋閉環(huán)。結合 src/mobilecli.ts、src/mobile-device.ts、src/server.ts 等源碼你可以看清每一步 Agent 操作背后的真實調用鏈——從 MCP 工具到 mobilecli 子命令再到xcrun simctl與 WebDriverAgent。這份文檔既是驗收腳本也是理解平臺無關移動自動化架構的最短路徑。贊分享人工智能AI AgentMCP 服務GUI 自動化移動開發(fā)測試【免費下載鏈接】mobile-mcpModel Context Protocol Server for Mobile Automation and Scraping (iOS, Android, Emulators, Simulators and Real Devices)項目地址https://gitcode.com/GitHub_Trending/mo/mobile-mcp點擊查看免費下載相關推薦LocalAI Assistant 管理員 MCP 服務器REST 端點、MCP 工具與 Skill 提示詞的三層契約設計與接入指南LocalAI Assistant 管理員 MCP 服務器REST 端點、MCP 工具與 Skill 提示詞的三層契約設計與接入指南 LocalAI 的 lo人工智能大模型模型推理服務本地部署LLM 網(wǎng)關多模態(tài)AI AgentRAGMCP 服務Google Jules 系統(tǒng)提示詞深度拆解自主編碼 Agent 的工具契約、規(guī)劃工作流與提交流程Google Jules 系統(tǒng)提示詞深度拆解自主編碼 Agent 的工具契約、規(guī)劃工作流與提交流程 Jules 是 Google 面向開發(fā)者提供的自主編碼 A文檔知識庫Vundle.vim插件安全加固增強安全性的終極指南Vundle.vim插件安全加固增強安全性的終極指南 Vundle.vim作為Vim的插件管理器幫助用戶輕松管理和安裝各類插件。然而在享受便捷的同時插件人工智能大模型AI Agent代碼智能體CLI工具調用MCP Clients創(chuàng)作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考