mijiaAPI

米家 API，可以使用代码、CLI、MCP 直接控制米家设备。

🎉 v4.0.0 版本已支持 MCP，详见 MCP 使用文档 🎉 v4.1.0 版本已支持 Agent Skill，详见 Agent Skill 使用文档

📖 完整文档请见 mijia-api.do1e.com

常见问题 | 更新日志

安装

要求 Python >= 3.10

pip install mijiaAPI
# Or `uv add mijiaAPI` for uv users

其他安装方式（源码安装、AUR）请参考文档。

快速开始

from mijiaAPI import mijiaAPI, mijiaDevice

# 初始化并扫码登录（认证文件默认保存在 ~/.config/mijia-api/auth.json）
api = mijiaAPI()
api.login()

# 通过设备名称控制设备（推荐）
device = mijiaDevice(api, dev_name="我的台灯")
device.on = True              # 打开设备
device.brightness = 60        # 设置亮度为 60%

# 查看设备支持的所有属性和动作
print(device)

CLI 用法：

mijiaAPI login                          # 扫码登录
mijiaAPI -l                             # 列出所有设备
mijiaAPI set --dev_name "台灯" --prop_name "brightness" --value 60

MCP 用法：

执行 uvx mijiaAPI login -p /path/to/auth.json 登录后，在 MCP 客户端配置中添加以下内容即可接入米家：

{
  "mcpServers": {
    "mijia-api": {
      "command": "uvx",
      "args": ["mijiaAPI", "mcp", "-p", "/path/to/auth.json"]
    }
  }
}

更多用法（API 基础调用、MCP Server、CLI 完整参数、最佳实践等）请查阅完整文档。

致谢

• janzlan/mijia-api
• 米家 APP 网络请求的抓包、加解密与构造的代码笔记
• al-one/hass-xiaomi-miot

开源许可

本项目采用 GPL-3.0 开源许可证。

请注意：GPL-3.0 是具有“强传染性”的开源许可证。
如果您在您的项目中使用、修改或分发本项目的代码（包括作为库依赖），您的整个项目也必须以 GPL-3.0 或兼容许可证开源发布。

免责声明

• 本项目仅供学习交流使用，不得用于商业用途，如有侵权请联系删除
• 用户使用本项目所产生的任何后果，需自行承担风险
• 开发者不对使用本项目产生的任何直接或间接损失负责