AI 開發者工具
sharkclean-mcp
針對 SharkClean / SharkNinja 掃地機器人的 MCP 伺服器,可透過任何 MCP 客戶端實現代理控制:以自然語言啟動清掃、清潔房間、返回基座及檢查狀態。
sharkclean-mcp
什麼是 sharkclean-mcp?
sharkclean-mcp 是一個 MCP 伺服器,允許 AI 代理透過自然語言指令控制 SharkClean 掃地機器人。它與 SharkNinja 的雲端後端通訊,以啟動清掃、清潔特定房間、返回基座及監控狀態。
如何使用 sharkclean-mcp?
- 1複製儲存庫並導航至其目錄。
- 2執行 'uv sync' 以安裝依賴項。
- 3將 .env.example 複製為 .env 並填入您的 SharkClean 應用程式電子郵件和密碼。
- 4執行 'uv run shark-mcp-auth' 以進行一次性瀏覽器登入。
- 5使用 'uv run shark-mcp-doctor' 驗證設定。
- 6使用提供的命令向您的客戶端(例如 Claude Code 或 Claude Desktop)註冊 MCP 伺服器。
sharkclean-mcp 主要功能
- 列出帳戶中的機器人
- 取得即時狀態(清掃中/暫停/已返回、電量、充電狀態、錯誤)
- 啟動全屋清掃並可選功率模式
- 從機器人地圖列出房間
- 清潔特定房間
- 暫停、繼續或停止清掃
- 讓機器人返回基座
- 設定功率模式(節能/標準/最強)
- 透過蜂鳴聲定位機器人
sharkclean-mcp 使用情境
- 透過 AI 助手啟動最強功率清掃
- 使用自然語言清掃廚房和客廳
- 檢查機器人狀態和電量
- 清掃後將機器人送回基座
- 在腳本或排程工作中自動化清掃任務
sharkclean-mcp 價格與免費點數
sharkclean-mcp 目前採用 免費 模式。
sharkclean-mcp 優缺點
優點
- 支援舊版 SDK 不支援的新型機器人
- 使用 MCP 協定進行 AI 整合
- 開源且文件清晰
- 支援多機器人帳戶
缺點
- 非官方,與 SharkNinja 無關聯
- 因 Auth0 限制需要一次性瀏覽器登入
- Auth0 權杖可能過期並需要重新驗證
- 房間定位需要機器人完成地圖
sharkclean-mcp 最適合哪些用途?
- 將 SharkClean 吸塵器整合到 AI 工作流程的開發者
- 使用 MCP 相容客戶端的家庭自動化愛好者
- 擁有較新型 SharkNinja 掃地機器人的使用者