HarmonyOS MCP Server

从 DevEco Code 提取的鸿蒙开发工具集，以 MCP Server 形式提供，可直接在原生 OpenCode 中使用。

配合 harmonyos-agent-skills 使用效果更佳 —— Skill 提供开发规范和工作流指引，MCP 提供可执行工具。

工具列表

| 工具 | 说明 | |------|------| | hdc_log | 收集/清理/列出 HarmonyOS 设备日志 | | arkts_check | ArkTS 静态语法检查 | | build_project | 通过 Hvigor 执行编译构建 | | start_app | 在模拟器/真机上运行应用 | | switch_cwd | 切换会话的项目上下文目录 | | list_devices | 列出已连接的鸿蒙设备 |

前置条件

• Node.js >= 22
• DevEco Studio >= 6.0（提供 Hvigor、HDC、Node）
• 设置 DEVECO_HOME 环境变量指向 DevEco Studio 安装目录

安装

方式一：npx（推荐，无需安装）

在 ~/.config/opencode/opencode.jsonc 中添加：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "harmony": {
      "type": "local",
      "command": ["npx", "@lhtdeg/harmony-mcp"],
      "enabled": true
    }
  }
}

然后重启 OpenCode 即可生效。npx 会自动下载并运行最新版本。

方式二：全局安装

npm install -g @lhtdeg/harmony-mcp

然后在 ~/.config/opencode/opencode.jsonc 中同样配置 npx @lhtdeg/harmony-mcp。

搭配 HarmonyOS Agent Skills

推荐安装官方的 HarmonyOS 开发 Skill 集合，提供完整的开发工作流指引：

npx skills add HarmonyOS_Skills/harmonyos-agent-skills

Skill 和 MCP 互补：

• Skill → 告诉 AI 怎么做（规范、流程、最佳实践）
• MCP → 让 AI 能做（编译、运行、调试）

使用流程

1. switch_cwd → 设置项目路径
2. arkts_check → 检查 ArkTS 语法
3. build_project → 编译构建
4. start_app → 运行到设备
5. hdc_log → 查看设备日志

环境变量

| 变量 | 说明 | 默认值 | |------|------|--------| | DEVECO_HOME | DevEco Studio 安装路径 | 自动检测 | | HDC_PATH | hdc 可执行文件完整路径 | 自动检测 | | HVIGOR_PATH | hvigorw.js 完整路径 | 自动检测 | | DEVECO_NODE_PATH | DevEco Studio 内置 Node 路径 | 自动检测 |

路径包含空格的解决方法

如果 DevEco Studio 安装在 C:\Program Files\Huawei\DevEco Studio 等包含空格的目录中，工具会自动处理路径引用。如果仍然失败，可以通过环境变量手动指定：

# PowerShell
$env:HDC_PATH = "C:\Program Files\Huawei\DevEco Studio\sdk\default\openharmony\toolchains\hdc.exe"
$env:HVIGOR_PATH = "C:\Program Files\Huawei\DevEco Studio\tools\hvigor\bin\hvigorw.js"
$env:DEVECO_NODE_PATH = "C:\Program Files\Huawei\DevEco Studio\tools\node\node.exe"

License

MIT