{"repo":"javen-yan/miot-mcp","free":true,"listed":false,"github":"https://github.com/javen-yan/miot-mcp","clone":"git clone https://github.com/javen-yan/miot-mcp.git","description":"基于 MijiaAPI 的米家设备智能控制代理，提供标准化的 MCP 服务，支持动态设备发现、属性读写和动作调用","language":"Python","stars":64,"topics":["mijia","xiaomi","mcp-server"],"license":"MIT","category":"mcp-servers","readme_excerpt":"米家 MCP Server 中文文档 English 一个基于 mijiaAPI 3.x 的产品化米家 MCP 服务。它不再要求客户端先理解 did 、 siid/piid/aiid 这些协议细节，而是优先面向“家庭、房间、设备名、场景名”提供更自然的查询和控制能力。 这版解决什么问题 - 面向 AI 客户端：优先暴露稳定、清晰的产品级工具，而不是底层协议字段 - 面向真实家庭场景：先看家庭与房间，再定位设备，再执行控制 - 面向 MCP 标准：工具返回结构化结果，服务状态和登录状态可直接被客户端消费 - 面向扩展：标准能力 schema、profile 驱动控制、资源模型可以继续演进 当前能力 服务与登录 - get service status - prepare login - reconnect service - clear saved login - refresh devices - get tool catalog - ping 家庭与设备 - get home overview - list homes - list devices - get device - get device status - get device capabilities 设备控制 - control by intent - control device - turn on device - turn off device - set brightness - set color temperature - set target temperature - set hvac mode - set fan speed - set cover position 场景与耗材 - list scenes - execute scene - get consumable items MCP 资源 - mijia://service - mijia://homes - mijia://devices - mijia://scenes - mijia://capabilities - mijia://tooling 安装 建议使用 Python 3.10+ 。 如果你不用 Poetry： 启动 测试握手： 登录方式 mijiaAPI 3.x 已移除账号密码登录，只支持二维码登录。 首次需要登录时，服务会： - 生成浏览器页： /.miot-mcp/qr.html - 同时生成二维码图片： /.miot-mcp/qr.png - 默认优先用系统浏览器打开 qr.html - 只有浏览器打不开时，才回退到图片查看器或终端二维码 认证信息会保存到： 推荐登录主路径 1. 调用 prepare login 2. 调用 get service status 3. 读取 service.qr.page path 或 service.qr.image path 4. 完成扫码后调用 reconnect service 或直接 refresh devices 登录相关状态 get service status 和 mijia://service 都会返回结构化登录状态，重点字段包括： - service.connected - service.has saved login - service.qr.open mode - service.qr.page path - service.qr.image path - service.qr.login url - assistant ","default_branch":null,"files":null,"tree":[],"storefront":"/r/javen-yan","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/javen-yan/miot-mcp/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}