Jenius MCP Smart Device

🚀 Jenius サポートのスマートホームコントロールツール

Jenius は、天聚地合（蘇州）科技股份有限公司 によって自主開発された 汎用マルチエージェントAIエージェント です。多エージェント協調アーキテクチャとリアルタイムデータサービス能力を深く融合することで、「ニーズ理解」から「正確な実行」までの全リンク閉ループを実現することを目指しています。Jenius は独自の「データ+エージェント+RPA」三角エンジンを開発し、天聚地合傘下の聚合データプラットフォームの膨大なリソースと自社開発のRPA技術を活用し、複雑なシーンの深度サービスニーズを解決することに特化しています。特に、旅行行程計画、マーケティング活動生成、レポート分析などの垂直分野で驚くべき実行力を発揮しています。

📦 プロジェクト構造

.
├── README.md                # プロジェクト説明ドキュメント
├── Home Assistant Guide.md  # Home Assistant 構築ガイド
├── jenius_mcp.py            # MCPサービスのメインエントリー
├── tools/                   # MCPツールセット
│   ├── __init__.py          # MCPツールセットの初期化ファイル
│   ├── common.py            # 汎用ツール関数
│   └── mcp/                 # MCPの具体的な実装
├── utils/                   # ツール関数
├── img/                     # プロジェクト画像
├── .mcp.env                 # MCP環境設定
├── Dockerfile               # Docker構築ファイル
├── mcp_server.tpl           # MCPサーバーテンプレート
├── pyproject.toml           # Pythonプロジェクト設定
├── requirements.txt         # Python依存ファイル
└── uv.lock                  # UV依存ロックファイル

🚀 クイックスタート

🏠 Home Assistant コントロールセンターの構築

Home Assistant を MCP サーバーとスマートホーム端末を接続するブリッジとして使用することをおすすめします。スマートホームデバイスを Home Assistant に接続し、スマートホームコントロールセンターのURLとキーを設定することで、MCPサーバーからスマートホームデバイスをリモートで制御することができます。具体的な操作手順は以下のドキュメントを参照してください。

Home Assistant 構築ガイド

⚙️ 環境設定

MCPサーバー環境設定

# SERVER HOST (Argパラメーターの渡し方をサポート)
JENIUS_SMART_DEVICE_MCP_HOST = 127.0.0.1

# Jenius MCP TRANSPORTプロトコル設定（Argパラメーターの渡し方をサポート）
JENIUS_SMART_DEVICE_MCP_TRANSPORT = stdio

# SSE方式を使用する場合、以下を設定する
JENIUS_SMART_DEVICE_MCP_SSE_PORT = YOUR_SSE_PORT
JENIUS_SMART_DEVICE_MCP_SSE_PATH = "/sse"
JENIUS_SMART_DEVICE_MCP_MESSAGE_PATH = "/messages/"

Home Assistant コントロールセンター環境設定

# スマートホームコントロールセンターのURL設定
CONTROL_CENTER_BASE_URL = YOUR_HOME_ASSISTANT_BASE_URL

# スマートホームコントロールセンターのリクエストヘッダー設定。アカウントに対応するキーを入力する必要があります。
CONTROL_CENTER__HEADERS = {"Authorization": YOUR_HOME_ASSISTANT_API_KEY, "Content-Type": "application/json"}

スマート端末環境設定

# 小米空気清浄機の制御
XIAOMI_AIR_PURIFIER_SWITCH_ENTITY_ID = "switch.zhimi_cn_495307311_rma1_on_p_2_1"
XIAOMI_AIR_PURIFIER_MODE_SELECT_ENTITY_ID = "select.zhimi_cn_495307311_rma1_mode_p_2_4"

# 小米スマートスピーカーの制御
XIAOMI_SPEAKER_SLEEPMODE_SWITCH_ENTITY_ID = "switch.xiaomi_cn_58102534_s12_sleep_mode_p_5_3"
XIAOMI_SPEAKER_MUTE_SWITCH_ENTITY_ID = "switch.xiaomi_cn_58102534_s12_mute_p_2_2"

# Roborock T7 掃除ロボットの制御
...

# 小米スマートカメラの制御
...

コントロールセンターのURL YOUR_HOME_ASSISTANT_BASE_URL とキー YOUR_HOME_ASSISTANT_API_KEY は、Home Assistant 構築ガイド の 第三 と 第四 の部分を参照して取得できます。

💻 UVのインストール

uv はPython環境管理ツールで、MCP公式が推奨するPythonプロジェクト管理ツールです。インストール方法は以下のリンクを参照してください。

https://docs.astral.sh/uv/getting-started/installation/

🚀 MCPサーバーの起動

依存パッケージがインストールされていない場合は、プロジェクトのルートディレクトリに移動して以下のコマンドを実行して同期してください。

uv sync

STDIOプロトコルで起動する場合（デフォルト）：

uv run jenius_mcp.py

起動パラメーターを自由に設定することができます。例えば：

uv run jenius_mcp.py --host 0.0.0.0 --port 8981 --transport sse

🖥️ クライアント設定

Cline, Claude Desktop などのクライアントを使用して、MCPサーバーを簡単に設定することができます。設定例は以下の通りです。

# STDIOモード
"juhe-mcp-smart_device": { 
    "command": "uv",
    "args": [
        "run",
        "jenius_mcp.py"
    ]
}

# SSEモード
"smart_home_server": {
    "url": "http://0.0.0.0:8981/sse",
    "transport": "sse"
}

✨ サポートされている端末

🌬️ 米家空気清浄機 4 Lite

🎶 小米AIスピーカー

🤖 米家 Roborock T7 掃除ロボット

📷 小米スマートカメラ

すべての 米家スマートデバイス は、環境設定ファイルで デバイスエンティティ識別子 を簡単に置き換えることで、すぐに接続することができます。デバイスエンティティ識別子の取得方法は、Home Assistant 構築ガイド の 第四 部分を参照してください。

💡 スマートコンセント SmartHW MF287

スマートコンセント の設定は、デバイスの使用説明書を参照してください。スマートコンセントには独自のIPアドレスとポートがあり、環境設定ファイルにデバイスのIP、ポートなどの情報を追加することで接続できます。同時に、コンセントに接続されている家具の種類に応じて、MCPサーバーのプロンプト内容と関数命名規則を変更することで、大規模モデルがよりよく理解して呼び出すことができます。

📄 ライセンス

このプロジェクトは Apache License 2.0 の下でライセンスされています。