MCP HarmonyOS

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

npx mcp-harmonyos

Configuration

For OpenCode

Add to your ~/.config/opencode/opencode.json:

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

For Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "harmonyos": {
      "command": "mcp-harmonyos"
    }
  }
}

Available Tools

Device Management

harmonyos_list_devices

List all connected HarmonyOS devices.

Returns: Array of devices with UDID and status

[
  {
    "udid": "7001005458323933328a01bcf4251a00",
    "status": "connected"
  }
]

harmonyos_get_device_info

Get detailed information about a specific device.

Parameters:

• deviceId (string): The device UDID

Returns: Device information including model, manufacturer, OS version, etc.

{
  "udid": "7001005458323933328a01bcf4251a00",
  "model": "HUAWEI Mate 60 Pro",
  "brand": "HUAWEI",
  "manufacturer": "HUAWEI",
  "osVersion": "4.0.0",
  "sdkVersion": "11",
  "buildId": "Mate60Pro 4.0.0.96"
}

Project Information

harmonyos_get_project_info

Get HarmonyOS project information from app.json5.

Parameters:

• projectPath (string): Absolute path to the HarmonyOS project root

Returns: Project metadata including bundleName, version, and modules

{
  "bundleName": "com.example.myapp",
  "versionCode": 1000000,
  "versionName": "1.0.0",
  "minCompatibleVersionCode": 1000000,
  "targetAPIVersion": 11,
  "modules": ["entry", "library"]
}

harmonyos_list_modules

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

Parameters:

• projectPath (string): Absolute path to the HarmonyOS project root

Returns: Array of modules with name, type, and path

[
  {
    "name": "entry",
    "type": "HAP",
    "path": "/path/to/project/entry",
    "srcPath": "entry"
  },
  {
    "name": "library",
    "type": "HSP",
    "path": "/path/to/project/library",
    "srcPath": "library"
  }
]

harmonyos_check_build_outputs

Check if build outputs exist and list them.

Parameters:

• projectPath (string): Absolute path to the HarmonyOS project root

Returns: Build output information

{
  "hasOutputs": true,
  "outputDir": "/path/to/project/outputs",
  "files": ["entry-default-signed.hap", "library-default-signed.hsp"],
  "haps": ["entry-default-signed.hap"],
  "hsps": ["library-default-signed.hsp"]
}

Application Management

harmonyos_list_installed_apps

List all installed applications on a device.

Parameters:

• deviceId (st

... View full README on GitHub