[!IMPORTANT] 这是由 rvaim 维护的非官方 npm 再发布版本，功能源代码未经修改。 上游：https://gitcode.com/openharmony-mcp/deveco-mobile-mcp.git 上游提交：b9a1e4ea07dddec102e9e0c14795c079c9f028ac 发布副本仅调整 npm 包名、仓库元数据、打包清单和本段说明。

deveco-mobile-mcp

An MCP (Model Context Protocol) server for mobile automation and development across HarmonyOS, iOS, and Android — supporting simulators, emulators, and real devices.

This project is a derivative work based on mobile-mcp by Mobile Next contributors, licensed under the Apache License 2.0. See NOTICE for attribution details.

What's Different from Upstream

This fork adds HarmonyOS device support on top of the original mobile-mcp:

• HarmonyOS device discovery, screenshot, element tree parsing
• App launch, terminate, install, uninstall via HDC
• URL opening with custom scheme support (e.g. alipays://)
• Key event mapping for HarmonyOS
• Multi-platform device log retrieval

Prerequisites

• Node.js >= 18
• Platform tools (at least one):
  • HarmonyOS: HDC (Huawei Device Connector)
  • iOS: Xcode command line tools
  • Android: Android Platform Tools

Quick Start

# Clone the repo
git clone https://gitcode.com/openharmony-mcp/deveco-mobile-mcp.git
cd deveco-mobile-mcp

# Install dependencies
npm install

# Build
npm run build

# Run
node lib/index.js

Platform Support

| Platform | Supported | |----------|:---------:| | HarmonyOS Real Device | ✅ | | iOS Real Device | ✅ | | iOS Simulator | ✅ | | Android Real Device | ✅ | | Android Emulator | ✅ |

MCP Tools

Device Management

• mobile_list_available_devices — List all available devices
• mobile_get_screen_size — Get screen size in pixels
• mobile_get_orientation — Get current screen orientation
• mobile_set_orientation — Change screen orientation

App Management

• mobile_list_apps — List installed apps
• mobile_launch_app — Launch an app by package name
• mobile_terminate_app — Terminate a running app
• mobile_install_app — Install an app from file
• mobile_uninstall_app — Uninstall an app

Screen Interaction

• mobile_take_screenshot — Take a screenshot
• mobile_save_screenshot — Save a screenshot to file
• mobile_list_elements_on_screen — List UI elements with coordinates
• mobile_click_on_screen_at_coordinates — Click at x,y coordinates
• mobile_double_tap_on_screen — Double-tap at coordinates
• mobile_long_press_on_screen_at_coordinates — Long press at coordinates
• mobile_swipe_on_screen — Swipe in any direction

Input & Navigation

• mobile_type_keys — Type text into focused elements
• mobile_press_button — Press device buttons (HOME, BACK, etc.)
• mobile_open_url — Open URLs in the device browser

Usage with Claude Code

claude mcp add deveco-mobile-mcp -- npx -y deveco-mobile-mcp

Or add to your MCP settings:

{
  "mcpServers": {
    "deveco-mobile-mcp": {
      "command": "node",
      "args": ["/path/to/deveco-mobile-mcp/lib/index.js"]
    }
  }
}

Upstream

This project is forked from mobile-mcp (Apache-2.0). For the original documentation, wiki, and roadmap, visit the upstream repository.

License

Apache License 2.0

Copyright 2025 deveco-mobile-mcp Contributors

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.