Skip to content

Home

Jump to bottom
Justin Gu edited this page May 2, 2026 · 5 revisions

🏠 MijiaPilot — Wiki

米家 × MCP × AI Agent × HomeKit 全桥接智能家居平台。

✨ 一句话介绍

用 AI 驱动你的米家设备。通过 REST API 和 MCP 协议，轻松对接 Claude Code、Hermes Agent 等 AI Agent 框架，实现自然语言控制智能家居；通过 HomeKit Bridge，还能在 Apple 家庭 App 和 Siri 中直接控制。

📋 快速导航

页面 说明
Home 项目总览（本页）
Installation 安装与配置指南
API Reference REST API 详细文档
CLI Guide 命令行工具使用指南
AI Integration AI Agent 集成指南
HomeKit Bridge Apple 家庭 & Siri 控制指南
Development 开发与贡献指南
FAQ 常见问题

🎯 核心功能

  • Web 管理界面 — 设备控制、场景管理、能耗统计、深色模式、移动端适配
  • RESTful API — JWT 认证 + Swagger 文档（/api/docs/），支持第三方集成
  • CLI 工具 — mijia-control 命令行，脚本化控制设备
  • AI Agent 友好 — 标准 API 接口，可直接对接 AI 框架
  • MCP Server — 内置 MCP 协议支持，Claude Code 等可一键接入
  • HomeKit 桥接 — Apple 家庭 App 和 Siri 直接控制米家设备
  • 实时通信 — SocketIO 推送设备状态变更
  • 定时自动化 — 支持 cron、interval、日出/日落触发

🏗️ 技术栈

Flask + SQLAlchemy + MySQL + SocketIO + Marshmallow + mijiaAPI + MCP + HAP-Python

详见 Installation 了解完整的环境要求和依赖。

🚀 5 分钟上手

git clone https://github.com/handsomejustin/mijia-control.git
cd mijia-control
python -m venv venv && source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -e ".[dev]"
cp .env.example .env   # 编辑 .env 填入数据库等配置
flask db upgrade
python run.py

访问 http://127.0.0.1:5000，注册账号即可使用。

🤝 致谢

底层使用 https://github.com/Do1e/mijia-api（mijiaAPI v3.0+）与小米云端通信，感谢原作者的开源贡献。

📄 许可证

https://www.gnu.org/licenses/gpl-3.0.html

Clone this wiki locally