Sam

🚀 安克創新掃地機器人MCP服務器

這是一個用於控制安克創新掃地機器人設備的模型上下文協議（MCP）服務器，採用TypeScript和Vite構建。

🚀 快速開始

📦 安裝指南

1. 安裝依賴項：

npm install

2. 獲取設備憑證：
   • 從安克創新智能家居應用程序或網絡分析中獲取設備ID和本地密鑰。
   • 在網絡中查找掃地機器人的IP地址。

💻 使用示例

基礎用法

# 以熱重載模式運行開發環境
npm run dev

# 進行類型檢查
npm run typecheck

高級用法

# 構建項目
npm run build

# 運行構建後的服務器
npm start

✨ 主要特性

可用工具

連接與設置

• robovac_scan_network - 掃描本地網絡以查找掃地機器人設備（🆕 無需憑證！）
• robovac_connect_discovered - 使用發現設備的IP地址進行連接。
• robovac_connect - 使用設備憑證進行手動連接。
• robovac_auto_initialize - 基於雲端的發現功能（⚠️ 由於API變更，可能無法正常工作）

基本控制

• robovac_start_cleaning - 開始清潔週期。
• robovac_stop_cleaning - 停止清潔週期。
• robovac_return_home - 返回充電座。
• robovac_play - 開始/繼續清潔。
• robovac_pause - 暫停清潔。
• robovac_find_robot - 讓掃地機器人發出蜂鳴聲以定位它。

高級控制

• robovac_set_work_mode - 設置清潔模式（AUTO、SMALL_ROOM、SPOT、EDGE、NO_SWEEP）。
• robovac_set_clean_speed - 設置吸力（STANDARD、BOOST_IQ、MAX、NO_SUCTION）。

狀態信息

• robovac_get_status - 獲取當前設備狀態（舊版）。
• robovac_get_battery - 獲取電池電量。
• robovac_get_error_code - 獲取當前錯誤代碼。
• robovac_get_work_mode - 獲取當前清潔模式。
• robovac_get_clean_speed - 獲取當前吸力水平。
• robovac_get_work_status - 獲取詳細工作狀態。
• robovac_get_play_pause - 獲取播放/暫停狀態。

實用函數

• robovac_format_status - 將格式化後的狀態信息打印到控制檯。
• robovac_get_all_statuses - 一次性獲取所有狀態信息。

與MCP客戶端配合使用

🆕 推薦：通過網絡掃描輕鬆設置

1. 掃描本地網絡以查找掃地機器人設備：

robovac_scan_network()

此操作將顯示以下信息：

• 所有開放塗鴉/安克創新端口（6668、6667、443）的設備。
• 具有安克創新MAC地址的設備（⭐ 可能是掃地機器人）。
• 潛在設備的IP地址。

2. 連接到發現的設備：

robovac_connect_discovered(ip="192.168.1.100", deviceId="your_device_id", localKey="your_local_key")

獲取設備憑證

你仍然需要設備ID和本地密鑰，可以通過以下方式獲取：

1. 嘗試社區工具：
   • eufy-security-client 或類似項目。
   • 在GitHub上查找更新的憑證獲取工具。
2. 網絡流量分析：
   • 監控安克創新應用程序的網絡流量。
   • 使用Wireshark或Charles Proxy等工具。
3. 路由器/固件方法：
   • 部分路由器會記錄設備信息。
   • 檢查掃地機器人固件是否會暴露憑證。

替代方法

手動連接（如果你已擁有所有憑證）：

robovac_connect(deviceId="your_device_id", localKey="your_local_key", ip="192.168.1.100")

雲端發現（由於API變更，可能無法正常工作）：

robovac_auto_initialize(email="your@email.com", password="your_password")

控制你的掃地機器人

連接成功後，你可以使用任意控制工具：

robovac_start_cleaning()
robovac_get_status()
robovac_return_home()
robovac_set_work_mode(mode="SPOT")
robovac_set_clean_speed(speed="MAX")