mobile-mcp-ai 2.7.10__py3-none-any.whl → 2.7.12__py3-none-any.whl

mobile_mcp/core/basic_tools_lite.py

@@ -2310,6 +2310,83 @@ class BasicMobileToolsLite:
         except Exception as e:
             return {"success": False, "message": f"❌ 按键失败: {e}"}
     
+    async def hide_keyboard(self) -> Dict:
+        """收起键盘
+        
+        在输入完成后收起键盘，确保页面元素不被键盘遮挡。
+        对于登录场景中需要勾选协议复选框非常有用。
+        
+        Returns:
+            包含操作结果的字典
+        """
+        try:
+            if self._is_ios():
+                ios_client = self._get_ios_client()
+                if ios_client and hasattr(ios_client, 'wda'):
+                    # iOS: 尝试点击键盘上的"完成"/"Done"按钮或发送回车收起键盘
+                    try:
+                        # 尝试点击键盘上的"完成"或"Done"按钮
+                        keyboard = ios_client.wda(className='XCUIElementTypeKeyboard')
+                        if keyboard.exists:
+                            # 尝试找 return/done/完成 按钮
+                            for btn_name in ['return', 'Return', 'done', 'Done', '完成']:
+                                try:
+                                    btn = keyboard.buttons[btn_name]
+                                    if btn.exists:
+                                        btn.click()
+                                        return {"success": True, "message": "✅ 键盘已收起 (iOS - 点击完成按钮)"}
+                                except:
+                                    continue
+                            
+                            # 如果没有找到按钮，尝试点击键盘以外的区域
+                            size = ios_client.wda.window_size()
+                            # 点击屏幕顶部区域（通常不会被键盘遮挡）
+                            ios_client.wda.click(size[0] // 2, 50)
+                            return {"success": True, "message": "✅ 键盘已收起 (iOS - 点击空白区域)"}
+                        else:
+                            return {"success": True, "message": "💡 键盘未显示，无需收起"}
+                    except Exception as e:
+                        # 退回到发送回车键
+                        ios_client.wda.send_keys('\n')
+                        return {"success": True, "message": f"✅ 键盘已收起 (iOS - 发送回车，原因: {e})"}
+                return {"success": False, "message": "❌ iOS 客户端未初始化"}
+            else:
+                # Android: 使用 back 键或 adb 命令收起键盘
+                try:
+                    # 方法1: 使用 adb shell 检测键盘状态
+                    # u2.shell() 返回 ShellResponse(output, exit_code)
+                    shell_result = self.client.u2.shell('dumpsys input_method | grep mInputShown')
+                    # 提取 output 字段（兼容字符串和 ShellResponse 两种情况）
+                    result = shell_result.output if hasattr(shell_result, 'output') else str(shell_result)
+                    
+                    if 'mInputShown=true' in result:
+                        # 键盘正在显示，按返回键收起
+                        self.client.u2.shell('input keyevent 4')  # KEYCODE_BACK
+                        time.sleep(0.3)
+                        
+                        # 验证键盘是否已收起
+                        shell_result_after = self.client.u2.shell('dumpsys input_method | grep mInputShown')
+                        result_after = shell_result_after.output if hasattr(shell_result_after, 'output') else str(shell_result_after)
+                        
+                        if 'mInputShown=false' in result_after:
+                            return {"success": True, "message": "✅ 键盘已收起 (Android - back键)"}
+                        else:
+                            # 如果 back 键没效果，尝试点击空白区域
+                            info = self.client.u2.info
+                            height = info.get('displayHeight', 1920)
+                            width = info.get('displayWidth', 1080)
+                            # 点击标题栏区域
+                            self.client.u2.click(width // 2, 100)
+                            return {"success": True, "message": "✅ 键盘已收起 (Android - 点击空白区域)"}
+                    else:
+                        return {"success": True, "message": "💡 键盘未显示，无需收起"}
+                except Exception as e:
+                    # 备用方案：直接按返回键
+                    self.client.u2.shell('input keyevent 4')
+                    return {"success": True, "message": f"✅ 键盘收起完成 (Android - back键，备用方案: {e})"}
+        except Exception as e:
+            return {"success": False, "message": f"❌ 收起键盘失败: {e}"}
+    
     def wait(self, seconds: float) -> Dict:
         """等待指定时间"""
         time.sleep(seconds)

mobile_mcp/mcp_tools/mcp_server.py

@@ -594,6 +594,12 @@ class MobileMCPServer:
             }
         ))
         
+        tools.append(Tool(
+            name="mobile_hide_keyboard",
+            description="⌨️ 收起键盘。【重要】输入密码后勾选协议前必须调用，确保复选框不被键盘遮挡。登录场景必备！",
+            inputSchema={"type": "object", "properties": {}, "required": []}
+        ))
+        
         # ==================== 应用管理 ====================
         tools.append(Tool(
             name="mobile_launch_app",
@@ -1040,6 +1046,10 @@ class MobileMCPServer:
                 result = self.tools.wait(arguments["seconds"])
                 return [TextContent(type="text", text=self.format_response(result))]
             
+            elif name == "mobile_hide_keyboard":
+                result = await self.tools.hide_keyboard()
+                return [TextContent(type="text", text=self.format_response(result))]
+            
             # 应用管理
             elif name == "mobile_launch_app":
                 result = await self.tools.launch_app(arguments["package_name"])

{mobile_mcp_ai-2.7.10.dist-info → mobile_mcp_ai-2.7.12.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mobile-mcp-ai
-Version: 2.7.10
+Version: 2.7.12
 Summary: 移动端自动化 MCP Server - 支持 Android/iOS，AI 功能可选（基础工具不需要 AI）
 Home-page: https://github.com/test111ddff-hash/mobile-mcp-ai
 Author: douzi
@@ -460,6 +460,7 @@ pip install pyautogui pyperclip pygetwindow
 | 👆 | `mobile_swipe` | 滑动 |
 | ⌨️ | `mobile_press_key` | 按键 |
 | ⏱️ | `mobile_wait` | 等待 |
+| ⌨️ | `mobile_hide_keyboard` | 收起键盘（登录场景必备） |
 | 📦 | `mobile_launch_app` | 启动应用 |
 | 📦 | `mobile_terminate_app` | 终止应用 |
 | 📦 | `mobile_list_apps` | 列出应用 |

{mobile_mcp_ai-2.7.10.dist-info → mobile_mcp_ai-2.7.12.dist-info}/RECORD

@@ -1,7 +1,7 @@
 mobile_mcp/__init__.py,sha256=sQJZTL_sxQFzmcS7jOtS2AHCfUySz40vhX96N6u1qy4,816
 mobile_mcp/config.py,sha256=-xSl9vahp3EFAA97P1ahcnQC-HHAFvccGHpnFAXeKHU,5841
 mobile_mcp/core/__init__.py,sha256=ndMy-cLAIsQDG5op7gM_AIplycqZSZPWEkec1pEhvEY,170
-mobile_mcp/core/basic_tools_lite.py,sha256=gEZ4Qp7H-bk8RR0Iiae2wyNbwjZMGLVrmwaJQF1Hh7Y,232724
+mobile_mcp/core/basic_tools_lite.py,sha256=iQtWjSkGEFGtJJ-pQrhJ3AedwyJ3Qj981tXs82xXZmI,237425
 mobile_mcp/core/device_manager.py,sha256=xG5DoeNFs45pl-FTEhEWblqVwxtFK-FmVEGlNL6EqRI,8798
 mobile_mcp/core/dynamic_config.py,sha256=Ja1n1pfb0HspGByqk2_A472mYVniKmGtNEWyjUjmgK8,9811
 mobile_mcp/core/ios_client_wda.py,sha256=Nq9WxevhTWpVpolM-Ymp-b0nUQV3tXLFszmJHbDC4wA,18770
@@ -19,14 +19,14 @@ mobile_mcp/core/utils/logger.py,sha256=XXQAHUwT1jc70pq_tYFmL6f_nKrFlYm3hcgl-5RYR
 mobile_mcp/core/utils/operation_history_manager.py,sha256=gi8S8HJAMqvkUrY7_-kVbko3Xt7c4GAUziEujRd-N-Y,4792
 mobile_mcp/core/utils/smart_wait.py,sha256=N5wKTUYrNWPruBILqrAjpvtso8Z3GRWCfMIR_aZxPLg,8649
 mobile_mcp/mcp_tools/__init__.py,sha256=xkro8Rwqv_55YlVyhh-3DgRFSsLE3h1r31VIb3bpM6E,143
-mobile_mcp/mcp_tools/mcp_server.py,sha256=RLqe4PqwVYVemLyShY6fKYUJ44pJg52k0VBJ6PTYyyQ,54402
+mobile_mcp/mcp_tools/mcp_server.py,sha256=nstcZqFx43MUm-wrc6mZfXqbmWU9PpP9O7pJi_C1ePY,54936
 mobile_mcp/utils/__init__.py,sha256=8EH0i7UGtx1y_j_GEgdN-cZdWn2sRtZSEOLlNF9HRnY,158
 mobile_mcp/utils/logger.py,sha256=Sqq2Nr0Y4p03erqcrbYKVPCGiFaNGHMcE_JwCkeOfU4,3626
 mobile_mcp/utils/xml_formatter.py,sha256=uwTRb3vLbqhT8O-udzWT7s7LsV-DyDUz2DkofD3hXOE,4556
 mobile_mcp/utils/xml_parser.py,sha256=QhL8CWbdmNDzmBLjtx6mEnjHgMFZzJeHpCL15qfXSpI,3926
-mobile_mcp_ai-2.7.10.dist-info/licenses/LICENSE,sha256=HrhfyXIkWY2tGFK11kg7vPCqhgh5DcxleloqdhrpyMY,11558
-mobile_mcp_ai-2.7.10.dist-info/METADATA,sha256=ly9jDsWcTfbOC_-oLynnWodDXPbw6P9lWaJ46__U9HY,11506
-mobile_mcp_ai-2.7.10.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-mobile_mcp_ai-2.7.10.dist-info/entry_points.txt,sha256=KB_FglozgPHBprSM1vFbIzGyheFuHFmGanscRdMJ_8A,68
-mobile_mcp_ai-2.7.10.dist-info/top_level.txt,sha256=lLm6YpbTv855Lbh8BIA0rPxhybIrvYUzMEk9OErHT94,11
-mobile_mcp_ai-2.7.10.dist-info/RECORD,,
+mobile_mcp_ai-2.7.12.dist-info/licenses/LICENSE,sha256=HrhfyXIkWY2tGFK11kg7vPCqhgh5DcxleloqdhrpyMY,11558
+mobile_mcp_ai-2.7.12.dist-info/METADATA,sha256=DF-5J-jSHnuS2xWWjEX1ky83sNuGB7c2-Ng09Nq_Ysc,11581
+mobile_mcp_ai-2.7.12.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+mobile_mcp_ai-2.7.12.dist-info/entry_points.txt,sha256=KB_FglozgPHBprSM1vFbIzGyheFuHFmGanscRdMJ_8A,68
+mobile_mcp_ai-2.7.12.dist-info/top_level.txt,sha256=lLm6YpbTv855Lbh8BIA0rPxhybIrvYUzMEk9OErHT94,11
+mobile_mcp_ai-2.7.12.dist-info/RECORD,,