# harmonyos-mcp 调研结论（2026-08-23）

## 用户的提议
用 harmonyos-mcp（MCP 服务）辅助鸿蒙开发。结论：可行且值得列入后续增强，但当前会话已具备等价能力，不阻塞壳版开发。

## 生态现状（公网检索）

| 项目 | 形态 | 能力 |
|---|---|---|
| harmonyos-mcp（npm） | npm 包 | DevEco 相关工具封装 |
| harmonyos-dev-mcp（pypi） | Python MCP | 设备自动化、应用部署、UI 交互、E2E、日志校验 |
| FadingLight9291117/mcp-harmonyos | GitHub | HarmonyOS 开发 MCP server |
| Eilgnaw/harmonyos-mcp | GitHub | 同类 |
| 华为官方 | 论坛指南 | 「在 Trae/Cursor 上开发鸿蒙应用」官方 MCP 使用指引（DevEco 侧 MCP 支持） |

## 与本项目的结合方式

DSH 官方带 dsh-mcp-client（MCP 客户端插件）：把 MCP server 挂载进 profile 后，Agent 会话就能获得结构化工具。接入路径：dsh plugin 添加 harmonyos-mcp 相关插件 → 重启 dsh web 会话 → 工具注入生效。

## 当前会话的替代现状（已验证等价）

- 编译：hvigor CLI（scripts/build.sh，已固化）
- 部署：hdc install / 启动（shell aa start）
- 截图：emulator -instance <name> -screenshot 或 hdc snapshot
- UI 注入：hdc shell uitest uiInput（click/swipe/text）
- 日志：hilog（hdc shell hilog）

结论：MCP 的价值在结构化与稳定性（避免 shell 引号/转义坑——本轮已多次踩到工具传输对复杂命令的干扰），建议列入 P2 阶段：协议原生线并行时挂载 harmonyos-dev-mcp 提升真机自动化可靠性。

## 风险提示

社区 MCP 质量参差（npm 上 harmonyos-mcp 有警告标记）；接入前需审计其工具面与权限（MCP 工具会获得设备控制权）。