How do I install Harmony?

Harmony is a local plugin. Install it using npm package: @yujiamei/harmony-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What AI apps work with Harmony?

Harmony uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Harmony MCP Server

by Xiaoxuzhu303 Prog

Developer ToolsUse Caution4.2MCP RegistryLocal

Free

Server data from the Official MCP Registry

AI copilot for WeChat Mini Program - auto compile-fix, size analysis, smart subpackage. 16 tools.

About

AI copilot for WeChat Mini Program - auto compile-fix, size analysis, smart subpackage. 16 tools.

Security Report

4.2

Use Caution4.2High Risk

harmony-mcp is a legitimate WeChat miniprogram development helper with sound authentication design (no auth required by design, as it's a local-only tool) and reasonable permissions that match its purpose. Code quality is good with proper error handling and input validation. However, there are moderate-severity concerns around unsanitized CLI argument passing and missing validation in file path inputs that could enable directory traversal or command injection attacks in edge cases. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.

7 files analyzed · 10 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

process_spawn

Check that this permission is expected for this type of plugin.

Shell Command Execution

Runs commands on your machine. Be cautious — only use if you trust this plugin.

system_info

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-xiaoxuzhu303-prog-harmony-mcp": {
      "args": [
        "-y",
        "@yujiamei/harmony-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

harmony-mcp

对 AI 说"帮我发个版本"，然后喝口水，完事了。

小程序开发者的 AI 副驾驶 —— 能理解你的项目、帮你一键发版、诊断编译错误的 MCP Server。

不需要云开发，不需要密钥，不需要白名单。装上就能用。

🚀 v0.2.0 重大更新：自动驾驶里程碑

🤖 报错全自动修复 — 新增 wechat_diagnose 契约 JSON，大模型现在能看懂行号和错误类型，自动修 Bug 并重新编译，直到 0 报错。

🔍 榨干官方 CI 能力 — 全面拦截微信底层 --info-output，精准排查 miniprogram_npm 中的体积炸弹（lodash/vant/echarts 一个都跑不掉）。

🗺️ AI 智能分包 — 主包超限时，AI 会直接根据依赖图为你生成 subpackages 代码，复制即用。

⚡ 快速开始

在你的 AI 工具（Kiro / Claude Desktop / Cursor 等）的 MCP 配置中添加：

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

前置条件

Node.js >= 18
微信开发者工具已安装（下载）
开发者工具「设置 → 安全 → 服务端口」已开启

💡 微信开发者工具安装在默认路径时会自动检测，无需额外配置。

✨ 能做什么

一键发版

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

一句话搞定原来 3-4 步的手动操作：版本递增 → npm 构建 → 上传代码。

包体积分析

你：包体积快超了，帮我看看
AI：📊 主包 1.8MB / 2MB（警告！）
    📁 images/ 占 42%（建议压缩）
    📁 vendor/ 占 28%（建议分包）
    💡 优化建议：1. 图片转 WebP  2. lodash 换 lodash-es  3. 大页面移入分包

编译诊断 → 自动修复

你：编译报错了帮我修
AI：❌ pages/cart/cart.js:42 - Cannot find module 'utils/pay'
    🔍 类型：模块缺失 | 指令：READ_FILE_AND_PATCH
    � 正在读取文件并修复...
    ✅ 重新编译通过！0 错误

AI 自动读取报错文件、修复代码、重新编译验证，直到零报错。最多 5 轮自动重试，超限自动刹车。

📋 全部工具（16 个）

工具	功能	说一句话就能触发
`wechat_diagnose`	编译诊断 + 自动修复闭环	"编译报错了帮我修"
`wechat_publish`	一键发版	"帮我发个版本"
`wechat_package_size`	包体积分析 + 官方精度	"包超了吗"
`wechat_subpackage_suggest`	智能分包建议	"主包超了怎么办"
`wechat_project_info`	读取项目配置	"帮我看看这个项目"
`wechat_page_list`	列出所有页面	"有哪些页面"
`wechat_config_validate`	配置文件校验	"配置有没有问题"
`wechat_dependency_check`	依赖健康检查	"依赖有问题吗"
`wechat_preview`	预览小程序	"预览一下"
`wechat_upload`	上传代码	"上传 1.2.0 版本"
`wechat_build_npm`	构建 npm	"构建一下 npm"
`wechat_cli_login`	登录开发者工具	"帮我登录"
`wechat_open_project`	打开项目	"打开项目"
`wechat_close_project`	关闭项目	"关闭项目"
`wechat_reset_fileutils`	重置文件监听	"重置文件缓存"
`wechat_self_test`	环境自检	"检查一下环境"

🆚 与其他方案的区别

	harmony-mcp	cloudbase-mcp	miniprogram-ci
需要云开发	❌	✅ 必须	❌
需要密钥/白名单	❌	✅	✅
AI 可直接调用	✅	✅	❌
能理解项目结构	✅	❌	❌
一键发版	✅	❌	❌
编译报错自动修复	✅	❌	❌
智能分包建议	✅	❌	❌
零配置使用	✅	❌	❌

harmony-mcp 面向不用云开发的 70% 普通小程序开发者。赛道内唯一能做到 AI 编译闭环的产品。

❓ 常见问题

提示"找不到微信开发者工具"

确认开发者工具已安装。如果安装在非默认路径，在项目根目录创建 harmony-mcp.json：

{
  "cliPath": "D:\\你的路径\\cli.bat"
}

提示"需要重新登录"

微信开发者工具登录态过期了。对 AI 说"帮我登录"，扫码即可。

支持 Mac 吗？

支持。自动检测 macOS 常见安装路径（/Applications/wechatwebdevtools.app 等）。

License

MIT © 朱

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

Harmony MCP Server

About

Security Report

Findings (10)Action required

Permissions Required

How to Install

Documentation

harmony-mcp

🚀 v0.2.0 重大更新：自动驾驶里程碑

⚡ 快速开始

前置条件

✨ 能做什么

一键发版

包体积分析

编译诊断 → 自动修复

📋 全部工具（16 个）

🆚 与其他方案的区别

❓ 常见问题

提示"找不到微信开发者工具"

提示"需要重新登录"

支持 Mac 吗？

License

Reviews

No reviews yet

More Developer Tools MCP Servers

Git

Toleno

mcp-creator-python

MarkItDown

mcp-creator-typescript

FinAgent