data-ai MCP Server
MijiaPilot - 小米-米家生态 × MCP × CLI x AI Agent × HomeKit 全桥接家庭智能家居平台。
Discovered via github-topic:mcp and last synced 3mo ago.
Install instructions not detected yet
Check the source repository for the latest setup steps.
设置设备属性（控制设备）
`venv\Scripts\mijia-control.exe`
执行设备动作
插座、智能开关
读取设备属性
查询 BLE 传感器历史读数
温度、湿度、电量
查看家庭详情
取暖器
查看设备详情与规格
获取 BLE 传感器最新数据
温度、湿度、电量
列出场景
扫地机、净化器等
列出家庭
空调伴侣、除湿机
列出所有设备
列出 BLE 传感器设备
温度、湿度、电量
温湿度传感器
[HAP-Python](https://github.com/ikalchev/HAP-python) >= 5.0
## 项目结构 ``` ├── app/ │ ├── __init__.py # Flask 应用工厂 │ ├── extensions.py # 扩展实例（db, jwt, csrf, socketio...） │ ├── api/ # REST API 蓝图 (JWT 认证) │ ├── web/ # Web UI 蓝图 (Session + CSRF 认证) │ ├── services/ # 业务逻辑层 │ ├── models/ # SQLAlchemy 数据模型 │ ├── schemas/ # Marshmallow 序列化/校验 │ ├── utils/ # MijiaAPI 适配器、统一响应、装饰器 │ ├── cli/ # Click CLI 命令 │ ├── homekit/ # HomeKit Bridge（Apple 家庭桥接） │ └── ble/ # BLE 蓝牙传感器守护进程（独立进程） ├── mcp_server/ # MCP Server（AI Agent 工具） ├── config/ # Flask 配置（development/testing/production） ├── migrations/ # Alembic 数据库迁移脚本 ├── tests/ # pytest 测试 ├── run.py # 开发服务器入口 ├── docs/ # 详细文档（HomeKit、API 等） └── pyproject.toml # 项目配置 & 依赖 ``` ## 快速开始 ### 1. 环境准备 - Python 3.10+ - MySQL 5.7+ ### 2. 安装 ```bash # 克隆本项目 git clone https://github.com/handsomejustin/mijia-control.git cd mijia-control # 创建虚拟环境 python -m venv venv source venv/bin/activate # Linux/Mac # venv\Scripts\activate # Windows # 安装依赖（mijiaAPI 会作为依赖自动安装） pip install -e ".[dev]" ``` ### 3. 配置 复制 `.env.example` 为 `.env` 并填写实际配置： ```bash cp .env.example .env ``` ```env FLASK_APP=app:create_app FLASK_ENV=development SECRET_KEY=your-secret-key-here DATABASE_URL=mysql+pymysql://user:[email protected]:3306/mijia JWT_SECRET_KEY=your-jwt-secret-key-here GO2RTC_URL=http://127.0.0.1:1984 ``` ### 4. 初始化数据库 ```bash # 创建 MySQL 数据库 mysql -u root -p -e "CREATE DATABASE mijia CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;" # 执行迁移 flask db upgrade ``` ### 5. 启动 ```bash python run.py ``` 访问 http://127.0.0.1:5000 ，注册账号后即可使用。 ## API 概览
执行场景
灯泡、灯带