Jenius MCP Smart Device

🚀 Jenius支持的智能家居控制工具

Jenius是由天聚地合（蘇州）科技股份有限公司自主研發的通用多智能體AI Agent。它深度融合多智能體協作架構與即時數據服務能力，致力於實現從“需求理解”到“精準執行”的全鏈路閉環。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 許可協議。