Merge pull request #60 from TencentCloudBase/claude/issue-53-20250710_120853

feat: implement miniprogram MCP plugin with latest miniprogram-ci v2.1.14

Author: binggg

doc/mcp-tools.md

@@ -1,6 +1,6 @@
 # MCP 工具
 
-CloudBase AI ToolKit 提供了完整的 MCP 工具集，支持云开发的各种操作。目前共有 **36 个工具**，涵盖环境管理、数据库操作、云函数管理、静态托管等核心功能。
+CloudBase AI ToolKit 提供了完整的 MCP 工具集，支持云开发的各种操作。目前共有 **40 个工具**，涵盖环境管理、数据库操作、云函数管理、静态托管、小程序发布等核心功能。
 
 📋 **完整工具规格**: [查看 tools.json](https://cnb.cool/tencent/cloud/cloudbase/CloudBase-AI-ToolKit/-/git/raw/main/scripts/tools.json)
 
@@ -13,6 +13,7 @@ CloudBase AI ToolKit 提供了完整的 MCP 工具集，支持云开发的各种
 | ⚡ [云函数管理](#云函数管理) | 9 个 | 函数创建、更新、调用、日志 |
 | 🌐 [静态托管](#静态托管) | 6 个 | 文件上传、管理、域名配置 |
 | 📁 [文件操作](#文件操作) | 2 个 | 文件下载、云存储上传 |
+| 📱 [小程序发布](#小程序发布) | 4 个 | 小程序上传、预览、构建、配置 |
 | 🛠️ [工具支持](#工具支持) | 4 个 | 模板下载、知识库搜索、联网搜索、交互对话 |
 
 ---
@@ -249,6 +250,54 @@ CloudBase AI ToolKit 提供了完整的 MCP 工具集，支持云开发的各种
 
 ---
 
+## 📱 小程序发布
+
+### 📤 代码管理
+
+#### `uploadMiniprogramCode`
+**功能**: 上传小程序代码到微信平台
+**参数**: 
+- `appId` (string): 小程序 appId
+- `projectPath` (string): 项目路径
+- `version` (string): 版本号
+- `desc` (string): 版本描述
+- `setting` (object): 编译设置
+- `robot` (number): 机器人编号 1-30
+- `type` (string): 项目类型 miniProgram/miniGame
+
+#### `previewMiniprogramCode`
+**功能**: 预览小程序代码并生成二维码
+**参数**: 
+- `appId` (string): 小程序 appId
+- `projectPath` (string): 项目路径
+- `desc` (string): 预览描述
+- `setting` (object): 编译设置
+- `robot` (number): 机器人编号 1-30
+- `type` (string): 项目类型 miniProgram/miniGame
+- `qrcodeFormat` (string): 二维码格式 image/base64/terminal
+- `qrcodeOutputDest` (string): 二维码输出路径
+- `pagePath` (string): 预览页面路径
+- `searchQuery` (string): 预览页面参数
+
+### 🔧 项目管理
+
+#### `buildMiniprogramNpm`
+**功能**: 构建小程序 npm 包
+**参数**: 
+- `appId` (string): 小程序 appId
+- `projectPath` (string): 项目路径
+- `type` (string): 项目类型 miniProgram/miniGame
+- `robot` (number): 机器人编号 1-30
+
+#### `getMiniprogramProjectConfig`
+**功能**: 获取小程序项目配置
+**参数**: 
+- `appId` (string): 小程序 appId
+- `projectPath` (string): 项目路径
+- `type` (string): 项目类型 miniProgram/miniGame
+
+---
+
 ## 🛠️ 工具支持
 
 ### 📚 辅助工具
@@ -285,6 +334,7 @@ CloudBase AI ToolKit 提供了完整的 MCP 工具集，支持云开发的各种
 - 🔍 **"查询环境信息"** → AI 调用 `envQuery` 工具  
 - 🚀 **"部署应用"** → AI 调用相关的部署工具
 - 📊 **"查询数据库"** → AI 调用 `queryDocuments` 工具
+- 📱 **"上传小程序"** → AI 调用 `uploadMiniprogramCode` 工具
 
 ## ⚙️ 配置说明
 
@@ -329,10 +379,11 @@ MCP 工具通过以下配置添加到你的 AI IDE 中：
 
 ## 🔄 工具优化
 
-为了提供更好的使用体验，我们将原来 40 个工具优化为 36 个：
+为了提供更好的使用体验，我们将原来的工具优化并新增了小程序发布功能，现在共有 40 个工具：
 
 - ✅ **envQuery**: 合并了 `listEnvs` + `getEnvInfo` + `getEnvAuthDomains`
 - ✅ **envDomainManagement**: 合并了 `createEnvDomain` + `deleteEnvDomain`  
 - ✅ **collectionQuery**: 合并了 `checkCollectionExists` + `describeCollection` + `listCollections`
+- ✅ **小程序发布**: 新增了 `uploadMiniprogramCode` + `previewMiniprogramCode` + `buildMiniprogramNpm` + `getMiniprogramProjectConfig`
 
-通过合并相关功能，减少了工具数量的同时保持了完整的功能覆盖。 
+通过合并相关功能和新增小程序发布工具，提供了更完整的云开发体验。 

doc/plugins.md

@@ -23,6 +23,7 @@ CloudBase MCP 采用插件化架构，支持按需启用工具模块，解决 MC
 | `rag` | 知识库搜索 (AI 增强问答) |
 | `download` | 远程文件下载 |
 | `gateway` | API 网关管理 |
+| `miniprogram` | 小程序发布 (上传、预览、构建) |
 
 ## ⚙️ 插件配置
 
@@ -63,9 +64,9 @@ CloudBase MCP 采用插件化架构，支持按需启用工具模块，解决 MC
 | 场景 | 推荐插件 |
 |------|----------|
 | **基础开发** | `env,database,functions,hosting` |
-| **完整功能** | `env,database,functions,hosting,storage,setup,interactive,rag,download,gateway` |
+| **完整功能** | `env,database,functions,hosting,storage,setup,interactive,rag,download,gateway,miniprogram` |
 | **纯后端** | `env,database,functions` |
-| **小程序** | `env,database,functions,storage,setup` |
+| **小程序** | `env,database,functions,storage,setup,miniprogram` |
 | **AI 应用** | `env,database,functions,hosting,rag,interactive` |
 
 ## 📚 相关文档

doc/plugins/miniprogram.md

@@ -0,0 +1,130 @@
+# 小程序插件
+
+小程序插件提供了微信小程序开发和部署的完整工具链支持，包括代码上传、预览、构建等功能。
+
+## 配置
+
+### 环境变量
+
+```bash
+# 设置小程序代码上传密钥（二选一）
+export MINIPROGRAM_PRIVATE_KEY="私钥内容"
+# 或者
+export MINIPROGRAM_PRIVATE_KEY_PATH="/path/to/private.key"
+
+# 启用小程序插件
+export CLOUDBASE_MCP_PLUGINS_ENABLED="env,database,functions,hosting,storage,setup,interactive,rag,gateway,download,miniprogram"
+```
+
+### MCP 配置
+
+```json
+{
+  "mcpServers": {
+    "cloudbase": {
+      "command": "npx",
+      "args": ["-y", "@cloudbase/cloudbase-mcp@latest"],
+      "env": {
+        "MINIPROGRAM_PRIVATE_KEY": "你的小程序私钥",
+        "CLOUDBASE_MCP_PLUGINS_ENABLED": "env,database,functions,hosting,storage,setup,interactive,rag,gateway,download,miniprogram"
+      }
+    }
+  }
+}
+```
+
+## 工具
+
+### uploadMiniprogramCode
+
+上传小程序代码到微信平台
+
+**参数：**
+- `appId`: 小程序 appId
+- `projectPath`: 项目路径
+- `version`: 版本号
+- `desc`: 版本描述（可选）
+- `setting`: 编译设置（可选）
+- `robot`: 机器人编号 1-30（可选）
+- `type`: 项目类型 miniProgram/miniGame（可选）
+
+### previewMiniprogramCode
+
+预览小程序代码并生成二维码
+
+**参数：**
+- `appId`: 小程序 appId
+- `projectPath`: 项目路径
+- `desc`: 预览描述（可选）
+- `setting`: 编译设置（可选）
+- `robot`: 机器人编号 1-30（可选）
+- `type`: 项目类型 miniProgram/miniGame（可选）
+- `qrcodeFormat`: 二维码格式 image/base64/terminal（可选）
+- `qrcodeOutputDest`: 二维码输出路径（可选）
+- `pagePath`: 预览页面路径（可选）
+- `searchQuery`: 预览页面参数（可选）
+
+### buildMiniprogramNpm
+
+构建小程序 npm 包
+
+**参数：**
+- `appId`: 小程序 appId
+- `projectPath`: 项目路径
+- `type`: 项目类型 miniProgram/miniGame（可选）
+- `robot`: 机器人编号 1-30（可选）
+
+### getMiniprogramProjectConfig
+
+获取小程序项目配置
+
+**参数：**
+- `appId`: 小程序 appId
+- `projectPath`: 项目路径
+- `type`: 项目类型 miniProgram/miniGame（可选）
+
+## 使用场景
+
+### 开发流程
+
+1. **构建依赖**
+   ```
+   调用 buildMiniprogramNpm 构建 npm 包
+   ```
+
+2. **预览测试**
+   ```
+   调用 previewMiniprogramCode 生成预览二维码
+   ```
+
+3. **发布上线**
+   ```
+   调用 uploadMiniprogramCode 上传代码到微信平台
+   ```
+
+### 密钥配置
+
+使用此插件前，需要在微信公众平台配置：
+
+1. 访问 [微信公众平台](https://mp.weixin.qq.com/)
+2. 进入"管理-开发管理-开发设置-小程序代码上传"
+3. 生成「代码上传密钥」
+4. 配置 IP 白名单（推荐开启）
+
+## 注意事项
+
+- 代码上传密钥拥有预览、上传代码的权限
+- 密钥不会明文存储在微信公众平台上
+- 密钥一旦遗失必须重置，请妥善保管
+- 建议开启 IP 白名单以降低安全风险
+
+## 常见问题
+
+### Q: 如何获取小程序 appId？
+A: 在微信公众平台的小程序管理页面可以查看到 appId。
+
+### Q: 机器人编号有什么作用？
+A: 机器人编号用于区分不同的上传任务，可以设置 1-30 之间的数字。
+
+### Q: 支持哪些编译设置？
+A: 支持 ES6/ES7 转换、代码压缩、WXSS 压缩等常见编译选项。

mcp/manifest.json

@@ -3,7 +3,7 @@
   "name": "@cloudbase/cloudbase-mcp",
   "displayName": "CloudBase AI ToolKit",
   "version": "1.8.8",
-  "description": "One-stop backend services for WeChat Mini-Programs and full-stack apps. Provides 34 specialized MCP tools for cloud development.",
+  "description": "One-stop backend services for WeChat Mini-Programs and full-stack apps. Provides 38 specialized MCP tools for cloud development.",
   "longDescription": "CloudBase AI ToolKit is a comprehensive MCP server that enables AI-powered development and deployment of full-stack applications to Tencent CloudBase. It provides seamless integration with WeChat Mini-Programs, serverless cloud functions, databases, and static hosting. Perfect for developers building applications targeting the Chinese market with WeChat ecosystem integration.",
   "author": {
     "name": "TencentCloudBase",
@@ -130,6 +130,22 @@
     {
       "name": "interactiveDialog",
       "description": "Interactive dialog for user confirmations and requirement clarification"
+    },
+    {
+      "name": "uploadMiniprogramCode",
+      "description": "Upload WeChat Mini-Program code to WeChat platform for deployment"
+    },
+    {
+      "name": "previewMiniprogramCode",
+      "description": "Preview WeChat Mini-Program code and generate QR code for testing"
+    },
+    {
+      "name": "buildMiniprogramNpm",
+      "description": "Build npm packages for WeChat Mini-Program projects"
+    },
+    {
+      "name": "getMiniprogramProjectConfig",
+      "description": "Get WeChat Mini-Program project configuration and settings"
     }
   ],
   "requirements": {

mcp/package.json

@@ -61,6 +61,7 @@
     "adm-zip": "^0.5.16",
     "cors": "^2.8.5",
     "express": "^5.1.0",
+    "miniprogram-ci": "^2.1.14",
     "open": "^10.1.2",
     "punycode": "^2.3.1",
     "ws": "^8.18.2",

mcp/src/server.ts

@@ -8,6 +8,7 @@ import { registerStorageTools } from "./tools/storage.js";
 import { registerRagTools } from './tools/rag.js';
 import { registerSetupTools } from "./tools/setup.js";
 import { registerInteractiveTools } from "./tools/interactive.js";
+import { registerMiniprogramTools } from "./tools/miniprogram.js";
 import { wrapServerWithTelemetry } from "./utils/tool-wrapper.js";
 import { registerGatewayTools } from "./tools/gateway.js";
 import { CloudBaseOptions } from "./types.js";
@@ -33,6 +34,7 @@ const AVAILABLE_PLUGINS: Record<string, PluginDefinition> = {
   rag: { name: 'rag', register: registerRagTools },
   download: { name: 'download', register: registerDownloadTools },
   gateway: { name: 'gateway', register: registerGatewayTools },
+  miniprogram: { name: 'miniprogram', register: registerMiniprogramTools },
 };
 
 /**