大家好，分享一个我折腾了挺久的开源项目：mijia-control。

一句话介绍

把米家设备全面 CLI 化 + API 化 + MCP 化，让 Hermes Agent 、Claude Code 、OpenClaw 等各种 AI Agent 能直接控制你家智能家居。顺便还兼容了 Apple HomeKit 。

为什么做这个

用 AI Agent 做自动化工作流的时候，发现智能家居这块是盲区 —— 米家 App 没有 CLI ，没有 API ，Agent 想控制设备只能走 GUI 模拟点击，体验很差。

思路很简单：所有设备操作都变成命令行和 API 调用，Agent 跑在终端里天然就能用。自己接语音识别的话，也能实现语音控制。

核心功能

1. MCP Server （ AI Agent 集成）

内置 MCP 协议支持，任何兼容 MCP 的 AI Agent 都能直接调用。目前 11 个工具：

list_devices    — 列出所有设备
get_device      — 查看设备详情与规格
get_property    — 读取设备属性
set_property    — 设置设备属性（控制设备）
run_action      — 执行设备动作
list_scenes     — 列出场景
run_scene       — 执行场景
list_homes      — 列出家庭
get_home        — 查看家庭详情
list_ble_devices / get_ble_sensor / get_ble_readings — BLE 传感器

在 Claude Code 里配置：

claude mcp add mijia -- python -m mcp_server

然后对话里直接说"把客厅灯关掉"、"执行回家场景"就行。Hermes Agent 、OpenClaw 同理。

2. CLI 工具

mijia-control 命令行，不依赖 Flask 上下文也能独立运行：

mijia-control device list                          # 列出设备
mijia-control device set <did> power on            # 开设备
mijia-control device get <did> temperature         # 读温度
mijia-control scene run <scene_id>                 # 执行场景
mijia-control ble scan                             # 扫描 BLE 传感器

有了 CLI ，配合任何自动化脚本、cron 定时任务、甚至 Shell 别名都能用。

3. RESTful API

完整的 REST API ，JWT 认证，Swagger 文档在 /api/docs/。覆盖设备管理、场景执行、自动化规则、能耗统计、BLE 传感器等所有功能。第三方系统（ Home Assistant 、n8n 等）集成很方便。

4. HomeKit 桥接

通过 HAP-Python 实现 HomeKit Bridge ，iPhone 家庭 App 和 Siri 能直接控制米家设备。支持灯光、插座、温控器、传感器等类型，还能自定义设备映射规则。

架构：

Apple 家庭 / Siri → HomeKit Bridge (51826) → Flask API (5000) → 米家设备

5. BLE 蓝牙传感器

PC 蓝牙直连小米 BLE 温湿度计，无需额外网关硬件。支持历史数据查询和自动化联动（比如温度超过 30°C 自动开空调）。

技术栈

Flask 3.0 + SQLAlchemy + MySQL ，MCP 用 FastMCP ，HomeKit 用 HAP-Python ，BLE 用 bleak 。代码质量用 Ruff lint + format ，pytest 测试。

适合谁用

• AI Agent 用户：想让 Hermes 、Claude Code 等 Agent 控制智能家居
• CLI 爱好者：习惯命令行操作，不想打开 App
• HomeKit 用户：想让米家设备出现在 Apple 家庭 App 里
• 自动化玩家：需要 API 对接 Home Assistant 、n8n 等系统

项目地址

https://github.com/handsomejustin/mijia-control

GPL-3.0 开源，欢迎 Star 和 PR 。底层通信用的 Do1e/mijia-api SDK ，感谢原作者的开源贡献。