Claude MCP Server for HarmonyOS development - 让 Claude Desktop 能直接构建、安装、调试 HarmonyOS 应用
DevEco Studio 的痛点：
- IDE 太重，只为构建和查看日志就得打开
- 构建错误信息混乱，截图给 LLM 不够清晰
用 MCP 工具：
你: 帮我构建 HarmonyOS 项目
Claude: [调用 hv_build 工具] 构建完成
你: 构建失败了，看看什么问题
Claude: [调用 hv_build，分析错误] 找到问题了，是类型错误...
- Node.js 18+
- HarmonyOS SDK (hvigorw, hdc)
git clone https://github.com/a0000/harmony-dev-cli.git
cd harmony-dev-cliMCP Server 依赖 hv 命令，需要先全局安装：
npm install -g .验证安装：
hv --versioncd mcp-server
npm install
npm run build编辑 Claude Code 配置文件：
- macOS:
~/.claude.json - Windows:
%APPDATA%\Claude\claude.json
{
"mcpServers": {
"harmonyos-control": {
"command": "node",
"args": ["/path/to/harmony-dev-cli/mcp-server/dist/index.js"]
}
}
}重启后 MCP 工具自动加载。
| 工具 | 说明 |
|---|---|
hv_build |
构建 HarmonyOS 项目 |
hv_install |
安装 HAP 到设备 |
hv_start |
启动 HarmonyOS 应用 |
hv_log |
查看应用日志 |
hv_doctor |
检查开发环境 |
重启 Claude Code 后，直接对话：
你: 帮我检查一下开发环境
Claude: [调用 hv_doctor] ✅ Node.js v20.x.x
✅ hvigorw 已安装
✅ hdc 已安装
✅ 设备已连接
你: 运行我的项目
Claude: [调用 hv_build → hv_install → hv_start]
🔨 正在构建...
✅ 构建成功
📦 正在安装...
✅ 安装成功
🚀 正在启动...
✅ 应用已启动
你: 查看应用日志
Claude: [调用 hv_log] 显示最新日志...
如果你想直接使用命令行工具，详见 plan/CLI-USAGE.md。
MIT