MCP Wyze Server

Instructions

Implementation Reference

• src/mcp_wyze_server/server.py:266-304 (handler)

  The handler function for the 'wyze_get_scale_info' tool. It uses the Wyze SDK to fetch detailed scale information including family members by device MAC address. The @mcp.tool() decorator automatically registers it with the MCP server.
  @mcp.tool() def wyze_get_scale_info(device_mac: str) -> Dict[str, Any]: """Get detailed information about a specific Wyze scale""" try: client = get_wyze_client() scale = client.scales.info(device_mac=device_mac) if scale is None: return {"status": "error", "message": f"Scale with MAC {device_mac} not found"} scale_info = { "mac": str(scale.mac) if scale.mac else "Unknown", "nickname": str(scale.nickname) if scale.nickname else "Unknown", "product_model": str(getattr(scale, 'product_model', 'Unknown')) if getattr(scale, 'product_model', 'Unknown') else "Unknown", "product_type": str(getattr(scale, 'product_type', 'Scale')) if getattr(scale, 'product_type', 'Scale') else "Scale", "is_online": bool(getattr(scale, 'is_online', True)), "firmware_ver": str(getattr(scale, 'firmware_ver', 'N/A')), } # Add family members if available if hasattr(scale, 'family_members') and scale.family_members: family_members = [] for member in scale.family_members: member_info = { "id": str(member.get("id", "Unknown")), "nickname": str(member.get("nickname", "Unknown")), "height": float(member.get("height")) if member.get("height") is not None else None, "goal_weight": float(member.get("goal_weight")) if member.get("goal_weight") is not None else None, } family_members.append(member_info) scale_info["family_members"] = family_members return {"status": "success", "scale": scale_info} except WyzeClientConfigurationError as e: return {"status": "error", "message": f"Configuration error: {str(e)}"} except WyzeRequestError as e: return {"status": "error", "message": f"API error: {str(e)}"} except Exception as e: return {"status": "error", "message": f"Unexpected error: {str(e)}"}
• src/mcp_wyze_server/server.py:21-45 (helper)

  Helper function to get or initialize the global Wyze client instance, used by wyze_get_scale_info and other tools.
  def get_wyze_client() -> Client: """Get or create Wyze client instance with auto-login if credentials available""" global _wyze_client if _wyze_client is None: # Get credentials from environment email = os.getenv("WYZE_EMAIL") password = os.getenv("WYZE_PASSWORD") key_id = os.getenv("WYZE_KEY_ID") api_key = os.getenv("WYZE_API_KEY") if not all([email, password, key_id, api_key]): raise WyzeClientConfigurationError( "Missing required environment variables: WYZE_EMAIL, WYZE_PASSWORD, WYZE_KEY_ID, WYZE_API_KEY" ) _wyze_client = Client( email=email, password=password, key_id=key_id, api_key=api_key ) return _wyze_client