大家好，分享一个我折腾了挺久的开源项目：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 ，感谢原作者的开源贡献。
Select Language