Ovládání robotických vysavačů SharkClean pomocí MCP

Repozitář sharkclean-mcp nabízí server pro ovládání robotických vysavačů SharkClean prostřednictvím Model Context Protocol (MCP). Tento server umožňuje uživatelům spouštět úklid, kontrolovat stav robota a ovládat ho pomocí přirozeného jazyka. Server je neoficiální a není spojen s firmou SharkNinja, což znamená, že jeho funkčnost může být ovlivněna změnami v backendu SharkNinja.

Server komunikuje s cloudem SharkNinja, konkrétně s backendem skegox, což umožňuje ovládání novějších modelů robotů. Server je postaven na reverzním inženýrství API skegox, které bylo vyvinuto projektem shark2mqtt. To umožňuje, aby roboty reagovaly stejně jako při ovládání z oficiální aplikace.

Pro spuštění serveru je vyžadováno prostředí Python verze 3.10 a nástroj uv. Uživatelé musí provést jednorázové přihlášení pomocí prohlížeče, protože headless přihlášení je blokováno detekcí botů Auth0. Po úspěšném přihlášení jsou tokeny pro přihlášení ukládány do souboru na disku, což usnadňuje další použití serveru.

Server podporuje více robotů a umožňuje specifikaci robota při volání příkazů. Příkazy jako 'start_cleaning' a 'clean_rooms' nejprve kontrolují, zda je robot online, což zajišťuje, že příkazy nebudou provedeny, pokud robot není dostupný. Mezi další dostupné příkazy patří 'return_to_dock' a 'set_power_mode', které uživatelům umožňují detailně ovládat chování robotů.

Je však důležité mít na paměti, že server je neoficiální a jeho funkčnost může být ovlivněna změnami v backendu SharkNinja. Starší modely robotů, které nemají podporu pro mapování místností, nemusí správně reagovat na pokyny. Taktéž je třeba brát v úvahu, že headless přihlášení je blokováno, což může být překážkou pro některé uživatele, kteří chtějí automatizovat procesy.