sharkclean-mcp es un servidor MCP (Model Context Protocol) no oficial creado por el desarrollador a-funk que permite controlar robots aspirador de SharkClean y SharkNinja desde cualquier cliente compatible con el protocolo, como Claude Code o Claude Desktop. Funciona como intermediario entre el usuario y el backend en la nube 'skegox' que utiliza la aplicación oficial SharkClean, lo que permite enviar instrucciones en lenguaje natural para iniciar limpiezas, limpiar estancias concretas, enviar el robot a la base de carga o consultar su estado, sin necesidad de modificar el hardware.
La principal ventaja frente a soluciones previas como sharkiqSDK, basadas en la nube legacy Ayla, es que sharkclean-mcp se conecta directamente a skegox, la infraestructura que utilizan los modelos más recientes (Matrix, AI Ultra, Mach 2, RV2500+). En Ayla, esos robots aparecían permanentemente 'fuera de línea' con un mapa de habitaciones obsoleto, aunque la app los controlara sin problemas. El proyecto incorpora el trabajo de ingeniería inversa del API skegox realizado por el proyecto shark2mqtt de CamSoper.
Entre las herramientas disponibles se incluyen list_robots, get_status, start_cleaning, list_rooms, clean_rooms, pause/resume/stop_cleaning, return_to_dock, set_power_mode y locate_robot. Los comandos start_cleaning y clean_rooms verifican primero que el robot esté en línea para evitar que las instrucciones se pierdan en silencio, y todas las funciones admiten un parámetro opcional de robot para cuentas con varios dispositivos. La limpieza por habitaciones requiere un robot con mapa completado.
La instalación se realiza con uv y Python 3.10 o superior, mediante clonación del repositorio, configuración de las credenciales de la app SharkClean en un archivo .env y un primer inicio de sesión manual en el navegador con PKCE, ya que el tenant Auth0 de SharkNinja bloquea los accesos headless. Una vez cacheado el token de refresco en ~/.config/shark-mcp/tokens.json, el servidor gestiona la rotación automáticamente. Además del servidor MCP, el proyecto incluye la utilidad de línea de comandos shark-mcp-rc para controlar el robot desde scripts o tareas cron. El repositorio dispone de pruebas unitarias, documentación de seguridad y una guía de contribución para registrar modelos compatibles.