@yujiamei/haymony-mcp

v0.7.0

Published

a month ago

HayMony MCP — 微信小程序 AI 副驾驶，可选鸿蒙 HDC 设备自动化（Beta）

0High
0Medium
0Low

yujiamei

mcp model-context-protocol haymony wechat miniprogram harmonyos devtools automation ai

HayMony MCP

微信小程序 AI 副驾驶，可选鸿蒙 HDC 设备自动化（Beta）。
npm：@yujiamei/haymony-mcp · 旧包 @yujiamei/harmony-mcp 已更名为 HayMony（见 CHANGELOG）。

微信小程序开发副驾驶 + HarmonyOS HDC 设备自动化 MCP Server（鸿蒙为 Beta 辅助能力）。让 Kiro、Cursor、Claude Desktop 等 AI 客户端直接执行本地开发者工具能力：编译诊断、合规预检、包体积分析、一键上传和鸿蒙设备操作。

当前 npm 稳定版：v0.7.0，共 42 个工具。

不需要云开发，不需要小程序 CI 密钥，不需要 IP 白名单。默认通过微信开发者工具官方 CLI 工作。

Quick Start · 核心能力 · 工具列表 · 配置 · FAQ

Quick Start

前置条件

Node.js >= 20
已安装微信开发者工具：下载地址
微信开发者工具中已开启「设置 -> 安全 -> 服务端口」

Kiro / Cursor / Claude Desktop

三类客户端配置内容相同，只是配置文件路径不同。

{
  "mcpServers": {
    "haymony-mcp": {
      "command": "npx",
      "args": ["-y", "@yujiamei/haymony-mcp"]
    }
  }
}

常见配置路径：

| 客户端 | 配置文件 | |------|----------| | Kiro | .kiro/settings/mcp.json | | Cursor | .cursor/mcp.json | | Claude Desktop macOS | ~/Library/Application Support/Claude/claude_desktop_config.json | | Claude Desktop Windows | %APPDATA%\Claude\claude_desktop_config.json |

Windows 如果 npx 启动不稳定，可以改用全局安装：

npm install -g @yujiamei/haymony-mcp

然后将配置改为：

{
  "mcpServers": {
    "haymony-mcp": {
      "command": "haymony-mcp",
      "args": []
    }
  }
}

核心能力

| 场景 | 你可以对 AI 说 | 做什么 | |------|----------------|--------| | 一键发版 | "帮我发个版本，描述是修复购物车 bug" | 读取版本、构建 npm、上传代码 | | 编译诊断 | "编译报错了，帮我定位" | 调用开发者工具编译，解析错误并给出修复建议 | | 包体积分析 | "主包快超了，帮我看看" | 分析包体积、定位大文件、给出分包建议 | | 合规预检 | "发版前检查一下合规" | 扫描 32 条审核高频规则 | | 代码审计 | "帮我检查代码质量" | 扫描 14 条运行时规则并评分 | | 鸿蒙设备 | "把这个 HAP 装到设备上" | 通过 HDC 安装、启动、看日志、传文件 |

一键发版

你：帮我发个版本，描述是修复了购物车 bug
AI：读取项目信息... OK
    构建 npm... OK
    上传代码 v1.2.4... OK
    发版完成。去微信后台提交审核即可。

编译诊断

你：编译报错了，帮我定位
AI：pages/cart/cart.js:42 Cannot find module 'utils/pay'
    类型：模块缺失
    源码：src/pages/cart/cart.tsx
    建议：检查 import 路径或补齐对应模块

合规预检

wechat_compliance_check 覆盖隐私弹窗、授权时机、虚拟支付、强制登录、web-view 域名、HTTPS、页面路径、tabBar、诱导分享、内容安全和敏感信息硬编码等高频审核问题。

工具列表

v0.7.0 稳定版共 42 个工具：

| 分类 | 数量 | 代表工具 | |------|------|----------| | 微信基础操作 | 10 | wechat_preview、wechat_auto_preview、wechat_cache_clean | | 微信项目分析 | 4 | wechat_project_info、wechat_package_size、wechat_subpackage_suggest | | 微信项目检查 | 4 | wechat_config_validate、wechat_audit、wechat_compliance_check | | 微信智能流程 | 3 | wechat_release_readiness、wechat_diagnose、wechat_publish | | 微信 CI / 环境 / 运行时 / 跨端 | 9 | wechat_ci_preview、wechat_cross_project_guide、wechat_runtime_diagnose | | HarmonyOS 设备操作 | 12 | harmony_ready_check、harmony_deploy_hap、harmony_log（diagnose） |

完整工具表见 docs/TOOLS.md。

配置

默认情况下无需配置。只有在微信开发者工具或 HDC 不在常见路径时，才需要在运行目录创建 haymony-mcp.json（仍兼容 harmony-mcp.json）。

{
  "cliPath": "D:\\Program Files\\Tencent\\微信web开发者工具\\cli.bat",
  "hdcPath": "D:\\Huawei\\Sdk\\openharmony\\toolchains\\hdc.exe",
  "appJsonPath": "src/app.json"
}

也可以通过环境变量指定微信开发者工具 CLI：

WECHAT_DEVTOOLS_CLI="D:\\Program Files\\Tencent\\微信web开发者工具\\cli.bat"

Roadmap

下一阶段继续补强：

| 能力 | 状态 | |------|------| | HarmonyOS 真机验证矩阵 | 计划中 | | uni-app / Taro 跨端指引 + wechat_cross_project_guide | v0.6.0 | | miniprogram-ci GitHub Actions 模板 | v0.6.0 见 docs/CI.md | | uni-app / Taro 源码映射增强 | 持续迭代 | | 运行时诊断 Beta 稳定化 | 持续迭代 | | 工具清单自动校验 | 计划中 |

MCP Prompts

在支持 MCP Prompts 的客户端中输入 /，可以看到 5 个快捷指令：

| 指令 | 功能 | |------|------| | /harmony-check | 一键环境预检 | | /harmony-pre-audit | 发版前体检（只读）：合规 + 质量 + 编译，可转发报告 | | /harmony-audit | 全量代码审计与评分报告 | | /harmony-shrink | 包体积分析与分包建议 | | /harmony-publish | 先 readiness，就绪并确认后再发版 |

更多示例见 docs/PROMPTS.md。

FAQ

连不上怎么办？

| 症状 | 常见原因 | 处理方式 | |------|----------|----------| | npx 启动报错 | Windows 环境兼容问题 | 改用全局安装：npm i -g @yujiamei/haymony-mcp | | 下载超时 | 网络或 npm registry 问题 | 执行 npm config set registry https://registry.npmmirror.com 后重试 | | 找不到微信开发者工具 | 安装路径非默认 | 配置 WECHAT_DEVTOOLS_CLI 或 haymony-mcp.json.cliPath | | 需要重新登录 | 微信开发者工具登录态过期 | 对 AI 说"帮我登录"，扫码确认 | | 工具调用无响应 | 服务端口未开启 | 微信开发者工具 -> 设置 -> 安全 -> 开启服务端口 |

支持跨端框架吗？

支持 uni-app、Taro、MPX 的基础识别与编译产物定位。当前稳定版已支持自动定位产物目录；更精确的源码映射增强正在 main 分支开发中。

会上传代码或修改文件吗？

只有调用上传、构建、初始化项目、鸿蒙安装等明确操作时才会产生外部动作。只读分析类工具会通过 MCP Tool Annotations 标注为只读，方便客户端做安全提示。

这是微信官方工具吗？

不是。本项目通过微信开发者工具官方公开 CLI 调用能力，不是微信官方产品。

法律声明 / Legal Disclaimer

中文

本项目（HayMony MCP / @yujiamei/haymony-mcp）为独立开源软件，与腾讯、华为及其关联公司无隶属、赞助或官方授权关系。
「微信」「微信小程序」「HarmonyOS」「华为」等名称及商标归各自权利人所有；本项目仅作平台与能力描述之用。
合规预检、发版就绪、代码质量评分等均为本地辅助分析，不保证通过微信或 HarmonyOS 应用商店/平台审核，亦不构成任何官方认证或法律意见。
使用微信开发者工具 CLI、miniprogram-ci、HDC 等须遵守相应平台开发者协议与工具使用条款；因用户滥用本工具导致的后果由用户自行承担。
本软件按 MIT 许可证「现状」提供，详见 LICENSE。

English

This project is independent open-source software, not affiliated with, endorsed by, or sponsored by Tencent, Huawei, or their subsidiaries.
Trademarks such as WeChat, Weixin Mini Program, HarmonyOS, and Huawei belong to their respective owners; references here are descriptive only.
Compliance checks, release readiness, and quality scores are assistive, local tooling only—they do not guarantee app-store or platform review approval and are not official certification or legal advice.
You must comply with Tencent’s and Huawei’s developer terms when using their CLIs and services. Misuse of this project is the user’s responsibility.
Provided “as is” under the MIT License.

Disclaimer

本项目非微信官方产品，与腾讯公司无任何关联。

HayMony MCP 通过调用微信开发者工具官方公开的 CLI 命令行接口实现微信小程序相关能力，不涉及逆向工程、协议破解或非公开接口调用。使用本工具前，请确保你已阅读并同意《微信小程序平台服务条款》。

"微信"及"小程序"为腾讯公司的注册商标，本项目中的使用仅用于描述兼容性，不构成任何官方背书。

本软件按"原样"提供，不附带任何明示或暗示的担保。作者不对因使用本软件导致的任何直接或间接损失承担责任。详见 LICENSE。