harmony-mcp

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

小程序开发者的 AI 副驾驶 —— 不只是命令代理，而是能理解你的项目、帮你一键发版的 MCP Server。

30 秒看懂

你：帮我看看这个项目的情况
AI：📋 AppID: wx1234...，3 个页面，2 个分包，基础库 3.6.0，ES6 已开启...

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

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

安装

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

{
  "mcpServers": {
    "harmony-mcp": {
      "command": "npx",
      "args": ["-y", "harmony-mcp"],
      "env": {
        "WECHAT_DEVTOOLS_CLI": "你的微信开发者工具cli.bat路径"
      }
    }
  }
}

前置条件

• Node.js >= 18

• 微信开发者工具已安装

• 开发者工具「设置 → 安全 → 服务端口」已开启

💡 如果微信开发者工具安装在默认路径，WECHAT_DEVTOOLS_CLI 环境变量可以不设，会自动检测。

能做什么

🔍 了解项目

"帮我看看这个项目的基本信息"

AI 会读取你的 project.config.json 和 app.json，告诉你：

• AppID、项目名称、基础库版本

• 页面列表和分包结构

• 编译配置（ES6、压缩、SourceMap 等）

• TabBar 和窗口配置

� 包体积分析

"包体积快超了，帮我看看哪些文件占空间大"

AI 自动完成：

• 扫描所有文件，按大小排序

• 按目录统计占比

• 对比微信 2MB 限制，给出警告

• 智能优化建议（图片压缩、分包策略、大文件处理）

🔧 编译诊断

"编译报错了帮我看看什么问题"

AI 自动完成：

• 触发编译，捕获错误

• 解析错误位置（文件、行号）

• 识别错误类型（语法、模块缺失、WXML 等）

• 给出修复建议

�🚀 一键发版

"帮我发个版本，描述是修复了支付流程"

AI 自动完成：

1. 读取当前版本号

2. 自动递增（支持 patch/minor/major）

3. 构建 npm 依赖

4. 上传代码到微信后台

一句话搞定原来 3-4 步的手动操作。

📱 日常操作

与其他方案的区别

harmony-mcp 面向不用云开发的 70% 普通小程序开发者。

全部工具

技术栈

• TypeScript

• @modelcontextprotocol/sdk（最新 registerTool API）

• stdio 传输模式

• Node.js >= 18

开发状态

• ✅ 基础操作层（7 个 CLI 工具）

• ✅ 项目理解（读取分析项目配置）

• ✅ 一键发版（版本递增 + 构建 + 上传）

• ✅ 包体积分析（文件扫描 + 大小统计 + 优化建议）

• ✅ 编译诊断（触发编译 + 错误解析 + 修复建议）

• ⬜ 鸿蒙 + 多平台扩展

文档

• 产品路线图

• 竞品分析

• 开发进度

• 测试报告

• 技术决策

• 更新日志

License

MIT