Genius 支持的智能家居控制工具

Genius 是由 天久滴河（苏州）科技有限公司 自主研发的 通用多代理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 服务器环境配置：

# 服务器主机（支持 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 许可证。