自然语言 ──> WorkBuddy ──> MCP ──> 本桥接服务器 ──> MQTT / HTTP / (可扩展)
                                                    │
                                                    └─> 真实设备 / 工厂 / 家居

# 1. 装依赖（已验证 Python 3.13）
pip install -r requirements.txt

# 2. 准备配置：复制示例，填入你的设备
cp config/devices.example.yaml config/devices.yaml

# 3. 启动 MCP 服务器（stdio，供 WorkBuddy 调用）
python -m src.server
# 或开发模式（自带 Inspector）：
mcp dev src/server.py

python verify.py

{
  "mcpServers": {
    "smart-hardware-bridge": {
      "command": "C:/Users/Administrator/.workbuddy/binaries/python/envs/shb/Scripts/python.exe",
      "args": ["-m", "src.server"],
      "cwd": "C:/Users/Administrator/WorkBuddy/2026-10-23-23-51-43/smart-hardware-bridge",
      "env": { "SHB_CONFIG": "config/devices.yaml" }
    }
  }
}

smart-hardware-bridge/
├── src/
│   ├── server.py            # FastMCP 服务器，暴露 4 个工具
│   ├── registry.py          # 配置加载 + 按协议路由
│   └── adapters/
│       ├── base.py          # 适配器抽象基类
│       ├── mqtt_adapter.py  # MQTT（ESP32/涂鸦/HA/工业）
│       └── http_adapter.py  # HTTP/REST（插座/摄像头/云）
├── config/
│   ├── devices.example.yaml # 配置示例
│   └── devices.yaml         # 你的真实配置（已 gitignore）
├── requirements.txt
├── verify.py                # 冒烟测试
├── LICENSE                  # MIT · 晨星
└── README.md