本仓库同时保存移动端、中控端和 D6 现场后端源码：
frontend/main/：OpenHarmony 横屏中控前端，来源于Harmon_LandscapeControl_OpenHarmony当前工作区。frontend/move/：OpenHarmony 移动端前端，来源于Harmon当前工作区。backend/d6-smart-home/：从 D6 设备/data/A9/smart_home拉取的后端源码快照。smart_home/：仓库原有的后端实现，保留用于历史兼容和版本对照。
构建产物、语音缓存、数据库、日志、设备密钥和真实环境变量不会提交。部署时请从 .env.example 创建本地配置，并通过环境变量设置 DEEPSEEK_API_KEY、A9_EDGE_SHARED_KEY、A9_DOOR_PASSWORD 和 A9_AI_DOOR_PASSWORD。不要把真实值写回仓库。
This is a MCP server for manipulating HarmonyOS Device, plus a Smart Home Gateway v5 running on HarmonyOS A9 board.
A complete smart home backend running on HarmonyOS A9 (ARM32), controlling 4 edge devices (10 real devices + 5 sensors) via TCP/UDP.
A9 Board (192.168.1.81:8080)
├── gateway_v5.py (:8080) ← HTTP API
├── hardware_bridge.py ← Hardware bridge
├── connect/ ← central_controller + devices.json
├── rag/rag_service.py ← RAG (65 exact commands + 44 TF-IDF)
├── channel.py (:8081) ← WebSocket + TTS output
└── data_pusher.py ← Data push
Edge Devices (2.4GHz Wi-Fi)
├── Living Room Hi3861 192.168.1.62:8000 (text protocol)
├── Kitchen H3863 192.168.1.23:8000 (binary) + UDP 8001
├── Bathroom H3863 192.168.1.63:8000 (binary)
└── Bedroom H3863 192.168.1.64:8000 (binary)
- 12-category stats API:
GET /api/stats— device online rate, area connectivity, temperature, humidity, smoke, thermal, alarm, fan, curtain, lights, alarm linkage, poll config - Real hardware only: No mock/simulated data. Offline =
null - Kitchen alarm linkage: alarm rising edge →
BEEP ALARM, falling edge →BEEP OFF, no repeat trigger - 1s kitchen polling: Smoke/thermal/alarm + UDP 8001 broadcast
- AI chat with device control: Intent detection → hardware execution → TTS voice confirmation
- RAG knowledge base: 65 exact command mappings + 44 TF-IDF entries
- Auto-start on boot:
/etc/init/smart_home.cfg
# Start gateway
hdc shell "sh /data/A9/run_v5.sh"
# Health check
hdc shell "cd /data/A9 && /data/A9/python-portable/lib/ld-musl-armhf.so.1 --library-path /data/A9/python-portable/lib:/data/A9/python-portable/usr/lib:/system/lib /data/A9/python-portable/usr/bin/python3.14 -c 'import urllib.request; print(urllib.request.urlopen(\"http://127.0.0.1:8080/health\", timeout=5).read().decode())'"
# Stats API
curl http://192.168.1.81:8080/api/stats
# Stop
hdc shell "pkill -f gateway_v5"| Endpoint | Method | Description |
|---|---|---|
/health |
GET | Health check {v:5, hardware:true} |
/api/stats |
GET | 12-category statistics |
/api/devices |
GET | 10 devices (offline=null) |
/api/sensors |
GET | 5 sensors (offline=null) |
/api/check |
GET | Connectivity check + voice broadcast |
/api/hardware/status |
GET | 4-area connectivity |
/api/alerts |
GET | Active alerts |
/api/sensors/history |
GET | Sensor history (24h) |
/api/devices/{id}/toggle |
POST | Toggle device |
/api/devices/{id}/control |
POST | Parameter control |
/api/door/control |
POST | Door control |
/api/chat/send |
POST | AI chat |
/api/voice/input |
POST | Voice input (ASR→backend) |
/api/tts/speak |
POST | TTS voice output |
smart_home/
├── gateway_v5.py ← Main HTTP gateway
├── channel.py ← WebSocket + TTS output
├── hardware_bridge.py ← Hardware bridge
├── data_pusher.py ← Data push service
├── connect/
│ ├── central_controller.py ← Edge device controller
│ └── devices.json ← Device configuration
├── rag/
│ └── rag_service.py ← RAG knowledge base
└── scenes/
└── scene_config.py ← Scene configuration
run_v5.sh ← Startup script
- Clone this repo
git clone https://github.com/xyls999/HarmonyOS-mcp-server.git
cd HarmonyOS-mcp-server- Setup the environment.
uv python install 3.13
uv syncYou can use Claude Desktop to try our tool.
DeepSeek-compatible endpoint example:
export DEEPSEEK_API_KEY="..."
export DEEPSEEK_BASE_URL="https://api.deepseek.com"
export DEEPSEEK_MODEL="deepseek-v4-flash"
uv run python examples/deepseek_agents_mcp.py "查看本地天气"Extra tools:
get_local_weather: get current weather by IP location or city name.list_common_harmony_apps: list friendly aliases for common HarmonyOS apps.launch_harmony_app: open an app by alias, package name, or fuzzy package keyword.
See langgraph_mcp.py for a complete LangGraph + MCP integration example.
MIT