v1.1.0 - Async hdc + Runtime Tools (install/launch/hilog/screenshot)

🚀 Release v1.1.0

This release backports security and feature improvements from the vscode-arkts extension, doubling the toolset and hardening the hdc call layer.

✨ New Tools (4)

Closing the build → install → launch → log → screenshot loop so AI assistants can fully drive HarmonyOS device workflows:

• harmonyos_install_app — Install a HAP package via hdc install (120s timeout for large HAPs)
• harmonyos_launch_app — Launch an app via aa start (defaults to EntryAbility, supports module/ability override)
• harmonyos_tail_hilog — Snapshot the device's hilog buffer with optional tag substring + log level filter (D/I/W/E/F)
• harmonyos_screenshot — Capture device screen via snapshot_display, pull to host as JPEG, auto-clean remote temp file

🔒 Security & Performance

• Eliminated shell injection risk: utils/hdc.ts rewritten from execSync + string concat to execFile + argv array. Values like deviceId and bundleName can no longer inject extra commands.
• All tool handlers now async: stops blocking the MCP server event loop, allowing concurrent tool calls.
• 10 MB stdout buffer: handles large outputs from hilog and bm dump without truncation.

📦 Installation

```bash
npm install -g mcp-harmonyos

or

npx mcp-harmonyos@1.1.0
```

🛠️ Full Tool List (11 total, was 7)

Device Management

• `harmonyos_list_devices` — List connected HarmonyOS devices
• `harmonyos_get_device_info` — Get device details (model, OS, SDK version)

Project Information

• `harmonyos_get_project_info` — Get bundleName, version, modules
• `harmonyos_list_modules` — List modules with types (HAP/HSP/HAR)
• `harmonyos_check_build_outputs` — Check build artifacts

Application Management

• `harmonyos_list_installed_apps` — List installed apps on device
• `harmonyos_get_app_info` — Get installed app details

Runtime (NEW in 1.1.0)

• `harmonyos_install_app` — Install HAP
• `harmonyos_launch_app` — Launch app
• `harmonyos_tail_hilog` — Tail device logs
• `harmonyos_screenshot` — Capture screenshot

🔧 Configuration

For Claude Desktop / Cursor / OpenCode, add to your MCP config:

```json
{
"mcpServers": {
"harmonyos": {
"command": "npx",
"args": ["-y", "mcp-harmonyos"]
}
}
}
```

🔗 Links

• NPM: https://www.npmjs.com/package/mcp-harmonyos
• Sister project: vscode-arkts (VS Code extension embedding these tools)

---

Full Changelog: v1.0.4...v1.1.0