Harmony MCP server

Read from the package source without running it. The installed server may list more.

• harmony_file_pull

  从鸿蒙设备拉取文件到本地指定路径。当用户说「把设备上的文件拉下来」时调用。

• harmony_file_push

  将本地文件推送到鸿蒙设备的指定路径。当用户说「把文件传到设备上」时调用。

• harmony_install

  将 HAP 安装包安装到指定鸿蒙设备。当用户说「装到设备上」「安装这个 hap」时调用。安装前建议先用 harmony_list_devices 确认目标设备。多设备时必须指定 target。

• harmony_list_devices

  列出当前已连接的鸿蒙设备和模拟器（connectKey、状态、类型）。当用户问「有哪些鸿蒙设备」或在执行其他鸿蒙操作前需要确认目标设备时调用。多设备场景下，其他鸿蒙工具需要用此处返回的 connectKey 指定 target。

• harmony_log

  抓取设备最近的 hilog 日志（默认最近 200 行）。当用户说「看看日志」「设备上报什么错了」时调用。可用 keyword 过滤。

• harmony_ready_check

  一次性检测鸿蒙开发环境：HDC 路径、HDC 版本、已连接设备。返回每项 pass/warn/fail 状态和修复 SOP。在执行鸿蒙设备操作前建议先调用确认环境就绪。如果返回 NOT_READY，请根据 failedChecks 的 sop 逐项引导用户修复。

• harmony_start

  在指定设备上启动应用的某个 Ability（相当于预览/拉起应用）。当用户说「在设备上跑起来」「启动这个应用」时调用。需要提供 bundleName 和 abilityName。

• harmony_uninstall

  从指定鸿蒙设备卸载应用（按 bundleName）。当用户说「卸载这个应用」时调用。多设备时必须指定 target。

• wechat_audit

  全面代码质量审计：11 条运行时规则扫描 + A/B/C/D 评分 + 具体问题列表。当用户说「帮我检查代码质量」「项目有没有问题」时调用。返回 suggestedActions 时请按顺序修复。

• wechat_build_npm

  构建小程序项目的 npm 依赖。当 wechat_diagnose 返回 REBUILD_NPM 指令、或用户新安装了 npm 包后需要调用此工具。构建完成后建议重新编译验证。

• wechat_cli_login

  登录微信开发者工具（会弹出二维码，需要用户手机微信扫码确认）。当其他工具返回 NEED_LOGIN 状态时，必须先调用此工具完成登录，再重试之前的操作。

• wechat_close_project

  关闭当前在微信开发者工具中打开的项目。当需要切换到另一个项目时使用。

• wechat_compliance_check

  合规预检：扫描隐私 API 调用（15 条规则）、检查权限声明、推断所需类目、标注个人主体限制。发版前调用避免审核被拒。返回缺失权限 + suggestedPatch（可直接帮用户补全 permission 配置）。

• wechat_config_validate

  校验 project.config.json 和 app.json 配置文件，检查 appid 格式、pages 为空、必填字段缺失等常见错误。当用户问「配置有没有问题」时调用。返回 suggestedActions 时请按顺序执行。

• wechat_dependency_check

  检查 npm 依赖状态：未构建的依赖、已知体积大户（lodash/moment 等）。当用户问「依赖有问题吗」或发版前调用。返回 suggestedActions 时请按顺序执行。

• wechat_diagnose

  触发小程序项目编译，捕获编译错误并结构化分析，给出修复建议。支持自动识别 uni-app/Taro/mpx 等跨框架项目。 如果返回 status="COMPILATION_FAILED"，你必须根据每个 error 的 agentActionHint 执行对应操作： - READ_FILE_AND_PATCH: 立刻读取 error.file 的 error.line 行附近代码，分析并修复错误 - ADD_PAGE_TO_APP_JSON: 在 app.json 的 pages 数组中添加缺失的页面路径 - REBUILD_NPM: 调用 wechat_build_npm 工具重新构建 npm - INSTALL_DEPENDENCY: 执行 npm install 安装缺失的依赖包 - FIX_CONFIG: 读取并修复对应的配置文件 - CHECK_COMPONENT_PATH:

• wechat_init_project

  在指定目录创建一个标准的微信小程序项目骨架，包含 project.config.json、app.json、app.js、首页等基础文件。 支持三种模板：blank（空白项目）、tabbar（带底部导航）、subpackage（带分包结构）。 创建完成后建议调用 wechat_open_project 在开发者工具中打开。

• wechat_open_project

  在微信开发者工具中打开指定项目。通常由自动恢复链路内部调用，用户一般不需要直接使用。

• wechat_package_size

  分析小程序包体积，返回主包/分包体积、文件明细、三方库排行、体积炸弹警告。当用户问「包超了吗」「体积多大」时调用。 如果 useOfficialReport=true 会触发一次预览编译获取精准数据。主包超 1.5MB 时建议调用 wechat_subpackage_suggest 获取分包方案。

• wechat_page_list

  列出小程序所有页面（主包 + 分包），标注分包归属和页面总数。当用户问「有哪些页面」「页面列表」时调用。

• wechat_preview

  预览小程序项目，生成二维码用于手机扫码预览。如果用户只是想检查编译是否通过，应优先使用 wechat_diagnose 而非此工具。

• wechat_project_info

  读取小程序项目全貌：AppID、页面列表、分包结构、编译配置、窗口设置。当用户第一次提到一个项目时应主动调用。支持 uni-app/Taro/mpx 跨框架自动识别（所有工具共享此能力）。

• wechat_publishwrite action

  一键发版：自动读取当前版本号并递增、构建 npm 依赖、上传代码到微信后台。调用前必须先调用 wechat_diagnose 确认编译零错误，只有编译通过才能发版，否则应先引导用户修复编译错误。 支持自动识别 uni-app/Taro/mpx 等跨框架项目。

• wechat_ready_check

  一次性检查微信开发者工具全链路状态：CLI 路径、进程运行、登录态、服务端口、项目合法性和可预览状态。 返回每个检查项的 pass/warn/fail 状态和具体修复 SOP。 建议在执行 preview/upload/diagnose 等操作前先调用此工具确认环境就绪。 如果返回 status="NOT_READY"，你必须根据 failedChecks 中每项的 sop 字段引导用户逐一修复。

• wechat_reset_fileutils

  重置微信开发者工具的文件监听缓存。当开发者工具出现文件不同步、修改不生效等异常时使用。通常由自动恢复链路内部调用。

• wechat_self_test

  检测 harmony-mcp 运行环境是否就绪（CLI 路径、开发者工具进程、Node 版本等）。当用户第一次使用本工具或询问'连上了吗/能用吗'时，应主动调用此工具进行自检，并将结果用自信的口吻告知用户。本工具同时包含隐私安全声明，请在用户有安全顾虑时引用。

• wechat_subpackage_suggest

  智能分包建议：分析页面依赖关系，生成分包方案 + 可直接使用的 app.json 配置片段 + 体积归因 + 预加载配置 + 分包后体积模拟。 当主包超 1.5MB 或 wechat_package_size 建议分包时调用。拿到 configSnippet 后，读取 app.json 合并 subpackages 并从 pages 中移除已分包页面。

• wechat_uploadwrite action

  上传小程序代码到微信后台。通常不需要直接调用此工具，推荐使用 wechat_publish（一键发版）来完成完整的发布流程。

• Code scan67 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitylocal package, no credentials required12/15
• Maintenancerepository not readable: repo not found3/15
• Maintainer identityno repository or website to verify2/10

Safety score

65/100

higher than 20% of 48,255 servers

Tools

28

the typical server has 7

Tools that change things

7%

typical: 0%. Fewer write tools means less an agent can break

Downloads a week

65

more than 51% of 12,191 servers with a package

Harmony: common questions

Is Harmony MCP server safe?

With care: it is graded C, so read the findings first (65/100). Read the Harmony safety report

How do I install Harmony?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does Harmony need an API key?

Not as far as the registry entry and our scan can tell: no credentials are declared or required.

Is Harmony maintained?

The latest release is v0.4.2.

How does Harmony compare with other MCP servers?

safety score 65/100 (higher than 20% of 48,255 servers); tools 28 (the typical server has 7); tools that change things 7% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.