fadinglight9291117 avatar

Harmonyos

fadinglight9291117/mcp-harmonyos

Wraps HarmonyOS Device Cooperation (hdc) command line tools to give Claude structured access to your HarmonyOS development environment. Query connected devices and their specs, read project metadata from app.json5, list installed applications with version info, and verify build outputs. Returns everything as typed JSON so Claude can inspect your project configuration, check which apps are on a device, or confirm builds completed before deploying. Designed to handle the query side while you use bash tools for actual compilation and deployment, keeping response times fast and avoiding timeouts on long operations. Requires DevEco Studio installed with hdc in your PATH.

GitHub stars
2
tools
7
transport
STDIO
last updated
Feb 15, 2026

Tools

7 tools

Public tool metadata for what this MCP can expose to an agent.

harmonyos_list_devicesList all connected HarmonyOS devices.

List all connected HarmonyOS devices.

No parameter schema in public metadata yet.

harmonyos_get_device_infoGet detailed information about a specific device.

Get detailed information about a specific device.

No parameter schema in public metadata yet.

harmonyos_get_project_infoGet HarmonyOS project information from app.json5.

Get HarmonyOS project information from app.json5.

No parameter schema in public metadata yet.

harmonyos_list_modulesList all modules in a project with their types (HAP/HSP/HAR).

List all modules in a project with their types (HAP/HSP/HAR).

No parameter schema in public metadata yet.

harmonyos_check_build_outputsCheck if build outputs exist and list them.

Check if build outputs exist and list them.

No parameter schema in public metadata yet.

harmonyos_list_installed_appsList all installed applications on a device.

List all installed applications on a device.

No parameter schema in public metadata yet.

harmonyos_get_app_infoGet detailed information about an installed application.

Get detailed information about an installed application.

No parameter schema in public metadata yet.

Sponsors

Readme

MCP HarmonyOS

npm: https://www.npmjs.com/package/mcp-harmonyos

NPM Version GitHub Stars License

A Model Context Protocol (MCP) server for HarmonyOS development. This server enables AI assistants like Claude to interact with HarmonyOS projects, devices, and applications.

Features

  • Device Management: List and query connected HarmonyOS devices
  • Project Information: Read project configuration, modules, and build outputs
  • Application Management: List and inspect installed applications on devices
  • Build Verification: Check build outputs and project structure

Prerequisites

  • Node.js 18+
  • HarmonyOS DevEco Studio (for hdc command-line tools)
  • hdc must be available in your PATH

Installation

Global Installation (Recommended)

npm install -g mcp-harmonyos

Or use with npx


View the full README on GitHub

Details

Repository
github.com/fadinglight9291117/mcp-harmonyos
Package
mcp-harmonyos
Transport
STDIO
Registry
MCP registry, active