Sam

🚀 Eufy RoboVac MCP Server

Eufy RoboVacデバイスを制御するためのモデルコンテキストプロトコル（MCP）サーバーです。TypeScriptとViteを使用して構築されています。

🚀 クイックスタート

📦 インストール

1. 依存関係をインストールします：

npm install

2. デバイスの資格情報を取得します：
   • Eufy Homeアプリまたはネットワーク分析からデバイスIDとローカルキーを取得します。
   • ネットワーク上でRoboVacのIPアドレスを見つけます。

💻 開発環境

ホットリロードで開発モードで実行します：

npm run dev

型チェックを行います：

npm run typecheck

🚀 本番環境

プロジェクトをビルドします：

npm run build

ビルドされたサーバーを実行します：

npm start

✨ 主な機能

接続とセットアップ

• robovac_scan_network - ローカルネットワークをスキャンしてRoboVacデバイスを探します（🆕 資格情報不要！）
• 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を音で探すためにブザーを鳴らします。

高度な制御

• 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デバイスを探します：

robovac_scan_network()

これにより、以下の情報が表示されます：

• 開いているTuya/Eufyポート（6668、6667、443）を持つすべてのデバイス
• Anker/EufyのMACアドレスを持つデバイス（⭐ おそらくRoboVac）
• 潜在的なデバイスの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. ネットワークトラフィック分析を行います：
   • Eufyアプリのネットワークトラフィックを監視します。
   • WiresharkやCharles Proxyなどのツールを使用します。
3. ルーター/ファームウェアの方法を試します：
   • 一部のルーターはデバイス情報を記録します。
   • RoboVacのファームウェアが資格情報を公開しているか確認します。

代替方法

手動での接続（すべての資格情報がある場合）：

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の制御

接続したら、任意の制御ツールを使用できます：

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