mobile-mcp-ai 2.5.2__py3-none-any.whl → 2.5.4__py3-none-any.whl

mobile_mcp/mcp_tools/mcp_server.py

@@ -89,6 +89,7 @@ class MobileMCPServer:
         self.client = None
         self.tools = None
         self._initialized = False
+        self._last_error = None  # 保存最后一次连接失败的错误
     
     @staticmethod
     def format_response(result) -> str:
@@ -99,9 +100,17 @@ class MobileMCPServer:
     
     async def initialize(self):
         """延迟初始化设备连接"""
-        # 如果已成功初始化，直接返回
+        # 如果已成功初始化，检查连接是否仍然有效
         if self._initialized and self.tools is not None:
-            return
+            # 验证设备连接是否仍然有效
+            if self._is_connection_valid():
+                return
+            else:
+                # 连接已失效，重置状态
+                print("⚠️ 检测到设备连接已断开，正在重新连接...", file=sys.stderr)
+                self._initialized = False
+                self.client = None
+                self.tools = None
         
         platform = self._detect_platform()
         
@@ -114,11 +123,40 @@ class MobileMCPServer:
             self._initialized = True  # 只在成功时标记
             print(f"📱 已连接到 {platform.upper()} 设备", file=sys.stderr)
         except Exception as e:
-            print(f"⚠️ 设备连接失败: {e}，下次调用时将重试", file=sys.stderr)
+            error_msg = str(e)
+            print(f"⚠️ 设备连接失败: {error_msg}，下次调用时将重试", file=sys.stderr)
             self.client = None
             self.tools = None
+            self._last_error = error_msg  # 保存错误信息
             # 不设置 _initialized = True，下次调用会重试
     
+    def _is_connection_valid(self) -> bool:
+        """检查设备连接是否仍然有效"""
+        try:
+            if self.client is None:
+                return False
+            
+            # Android: 检查 u2 连接
+            if hasattr(self.client, 'u2') and self.client.u2:
+                # 尝试获取设备信息，如果失败说明连接断开
+                self.client.u2.info
+                return True
+            
+            # iOS: 检查 wda 连接
+            if hasattr(self.client, 'wda') and self.client.wda:
+                self.client.wda.status()
+                return True
+            
+            # iOS (通过 _ios_client)
+            if hasattr(self.client, '_ios_client') and self.client._ios_client:
+                if hasattr(self.client._ios_client, 'wda') and self.client._ios_client.wda:
+                    self.client._ios_client.wda.status()
+                    return True
+            
+            return False
+        except Exception:
+            return False
+    
     def _detect_platform(self) -> str:
         """自动检测设备平台"""
         platform = os.getenv("MOBILE_PLATFORM", "").lower()
@@ -722,7 +760,20 @@ class MobileMCPServer:
         await self.initialize()
         
         if not self.tools:
-            return [TextContent(type="text", text="❌ 设备未连接，请检查连接状态")]
+            # 提供详细的错误信息和解决方案
+            error_detail = self._last_error or "未知错误"
+            help_msg = (
+                f"❌ 设备连接失败\n\n"
+                f"错误详情: {error_detail}\n\n"
+                f"🔧 解决方案:\n"
+                f"1. 检查 USB 连接: adb devices\n"
+                f"2. 重启 adb: adb kill-server && adb start-server\n"
+                f"3. 初始化 uiautomator2: python -m uiautomator2 init\n"
+                f"4. 手机上允许 USB 调试授权\n"
+                f"5. 确保手机已解锁\n\n"
+                f"完成后请重试操作。"
+            )
+            return [TextContent(type="text", text=help_msg)]
         
         try:
             # 截图

{mobile_mcp_ai-2.5.2.dist-info → mobile_mcp_ai-2.5.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mobile-mcp-ai
-Version: 2.5.2
+Version: 2.5.4
 Summary: 移动端自动化 MCP Server - 支持 Android/iOS，AI 功能可选（基础工具不需要 AI）
 Home-page: https://github.com/test111ddff-hash/mobile-mcp-ai
 Author: douzi

{mobile_mcp_ai-2.5.2.dist-info → mobile_mcp_ai-2.5.4.dist-info}/RECORD

@@ -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=PvKXImfN9Irru3bQJUjf4FLGn8LjY2VLzUNEl-i7xLE,8601
 mobile_mcp/mcp_tools/__init__.py,sha256=xkro8Rwqv_55YlVyhh-3DgRFSsLE3h1r31VIb3bpM6E,143
-mobile_mcp/mcp_tools/mcp_server.py,sha256=K53DSxKGT3B_f6mqaoTID2th5luBtwlh5MjoUDGbhl0,45263
+mobile_mcp/mcp_tools/mcp_server.py,sha256=wqNOkjWYxxPYTAjU8e8yn8EyeRtO9NMhPTqGZ18jfnM,47471
 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.5.2.dist-info/licenses/LICENSE,sha256=HrhfyXIkWY2tGFK11kg7vPCqhgh5DcxleloqdhrpyMY,11558
-mobile_mcp_ai-2.5.2.dist-info/METADATA,sha256=fqKamhjV66KFBFvcfGrfHYFKb-zB75P8-mqEVuhDlSI,9745
-mobile_mcp_ai-2.5.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-mobile_mcp_ai-2.5.2.dist-info/entry_points.txt,sha256=KB_FglozgPHBprSM1vFbIzGyheFuHFmGanscRdMJ_8A,68
-mobile_mcp_ai-2.5.2.dist-info/top_level.txt,sha256=lLm6YpbTv855Lbh8BIA0rPxhybIrvYUzMEk9OErHT94,11
-mobile_mcp_ai-2.5.2.dist-info/RECORD,,
+mobile_mcp_ai-2.5.4.dist-info/licenses/LICENSE,sha256=HrhfyXIkWY2tGFK11kg7vPCqhgh5DcxleloqdhrpyMY,11558
+mobile_mcp_ai-2.5.4.dist-info/METADATA,sha256=EUiIZ3uxIiyK-P9Sf558k8nu6dAWnl1U6mcjBby0Lso,9745
+mobile_mcp_ai-2.5.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+mobile_mcp_ai-2.5.4.dist-info/entry_points.txt,sha256=KB_FglozgPHBprSM1vFbIzGyheFuHFmGanscRdMJ_8A,68
+mobile_mcp_ai-2.5.4.dist-info/top_level.txt,sha256=lLm6YpbTv855Lbh8BIA0rPxhybIrvYUzMEk9OErHT94,11
+mobile_mcp_ai-2.5.4.dist-info/RECORD,,