项目简介
米家设备的 API,可以使用代码直接控制米家设备。
特性
- 扫码登录:通过二维码登录米家账号,认证数据自动保存,Token 自动刷新
- API 基础调用:直接使用 siid/piid 获取/设置设备属性、执行设备动作
- 高级设备封装:
mijiaDevice类提供面向对象的设备控制,无需关心 siid/piid - CLI 命令行工具:直接在终端控制设备,支持
uvx免安装运行 - MCP Server:让 LLM(如 Claude)直接控制米家设备,支持会话内二维码登录
- Agent Skill:内置 AI 助手 skill 定义,让 LLM 通过 CLI 安全控制设备
- 场景控制:获取场景列表并执行手动场景
- 耗材管理:获取耗材列表(如滤芯、灯泡等)
- 统计数据:获取设备统计数据(如耗电量)
- 设备规格查询:从米家规格平台在线获取设备属性和动作信息
环境要求
- Python >= 3.10
