Supports containerized deployment of the MCP server through Docker, allowing for isolated and consistent execution environments.
Connects to a Home Assistant instance to control smart home devices, serving as a bridge between the MCP server and smart home endpoints.
Enables control of Xiaomi smart devices including the Mi Air Purifier 4 Lite and Xiaomi AI Speaker, with capabilities to manage power, modes, and other device-specific functions.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Jenius MCP Smart Deviceturn on the air purifier in the living room"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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依赖锁定文件使用流程
Related MCP server: Home Assistant MCP Server
搭建 Home Assistant 控制中心
我们建议使用 Home Assistant 作为连接MCP服务器和智能家居终端的桥梁。通过把智能家居设备接入 Home Assistant，并配置智能家居控制中心 URL 和密钥，即可快速实现 MCP 服务器对智能家居设备的远程控制。具体操作请参考以下文档：
配置环境
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 项目管理工具，安装方式见：
启动 MCP 服务器
如果没有安装依赖包，可进入项目根目录执行命令进行同步：
uv syncSTDIO协议启动（默认）：
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服务器的提示词内容和函数命名规则，以便大模型更好地理解并调用。
开源协议
This project is licensed under the Apache License 2.0.