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