RFC 支持小程序发布 MCP 插件

[binggg]

当前项目支持 插件机制，新增一个 mp 的 MCP 插件模块

支持小程序/小游戏的常见操作

https://www.npmjs.com/package/miniprogram-ci

https://developers.weixin.qq.com/miniprogram/dev/devtools/ci.html

上传代码，对应小程序开发者工具的上传
预览代码，对应小程序开发者工具的预览
构建 npm，对应小程序开发者工具的: 菜单-工具-构建npm
代码静态检查
代码质量分析等

需要注意使用这个MCP 模块，需要配置对应的密钥及 IP 白名单配置

使用 miniprogram-mp-ci 前应访问"微信公众平台-管理-开发管理-开发设置-小程序代码上传"生成「代码上传密钥」，并配置 IP 白名单 开发者可选择打开 IP 白名单，打开后只有白名单中的 IP 才能调用相关接口。我们建议所有开发者默认开启这个选项，降低风险 代码上传密钥拥有预览、上传代码的权限，密钥不会明文存储在微信公众平台上，一旦遗失必须重置，请开发者妥善保管

如果使用这个插件，需要在环境变量中传入代码上传密钥或者路径

[binggg]

@claude 来搞定这个，要求最小可用，API 简单，不要太复杂

[claude]

Claude finished @binggg's task —— View job • claude/issue-53-20250710_092721 • Create PR ➔

---

实现小程序发布 MCP 插件 ✅

我来帮你实现这个小程序发布的 MCP 插件。让我先分析现有的 MCP 插件结构，然后创建一个简单可用的版本。

任务清单:

• 分析现有 MCP 插件结构
• 创建 mp MCP 插件目录和基础文件
• 实现核心功能（上传、预览、构建npm等）
• 添加配置处理
• 更新相关文档
• 测试和提交更改

已完成的功能:

• ✅ 创建了 mcp/src/tools/miniprogram.ts 文件
• ✅ 实现了 4 个核心工具：
  • uploadMiniprogramCode - 上传小程序代码
  • previewMiniprogramCode - 生成预览二维码
  • buildMiniprogramNpm - 构建npm包
  • getMiniprogramProjectConfig - 获取项目配置
• ✅ 添加了 miniprogram-ci@^1.10.0 依赖
• ✅ 更新了 server.ts 注册新插件
• ✅ 更新了 manifest.json 添加新工具（总工具数从34增加到38）
• ✅ 创建了详细的使用文档
• ✅ 提交并推送到分支 claude/issue-53-20250710_092721

实现要点

API 设计简单明了：

• 每个工具都有清晰的参数和返回值
• 支持环境变量配置，便于安全管理
• 提供详细的错误处理和反馈

支持的核心功能：

• 上传代码到微信平台（对应开发者工具的上传功能）
• 预览代码生成二维码（对应开发者工具的预览功能）
• 构建npm包（对应开发者工具的构建npm功能）
• 获取项目配置信息

配置方式：

# 设置私钥内容或路径
export MINIPROGRAM_PRIVATE_KEY="私钥内容"
# 或者
export MINIPROGRAM_PRIVATE_KEY_PATH="/path/to/private.key"

已成功实现最小可用版本，API 简单，功能完整。

[binggg]

@claude 有几个优化建议

1. privateKeyPath: z.string().optional().describe("代码上传密钥路径，如果不提供将从环境变量 MINIPROGRAM_PRIVATE_KEY_PATH 中读取"),
   privateKey: z.string().optional().describe("代码上传密钥内容，如果不提供将从环境变量 MINIPROGRAM_PRIVATE_KEY 中读取"),
   这种配置不要出现在 mcp 的 tool 的参数中，不太好

2. 文档统一放在 doc 目录，专门插件的目录，写这个插件的文档，文档不要太啰嗦

3. 小程序 插件不要放在默认插件中

[claude]

Claude finished @binggg's task —— View job • claude/issue-53-20250710_095137 • Create PR ➔

---

优化小程序 MCP 插件 ✅

已根据你的优化建议完成小程序 MCP 插件的重新实现。

任务清单:

• 分析当前实现状态
• 创建小程序 MCP 插件（miniprogram.ts）
• 实现核心功能（上传、预览、构建npm等）
• 配置处理仅使用环境变量（不在工具参数中）
• 添加 miniprogram-ci 依赖到 package.json
• 将插件注册到 AVAILABLE_PLUGINS（但不加入 DEFAULT_PLUGINS）
• 创建 doc/plugins/miniprogram.md 文档
• 更新 manifest.json 添加工具定义
• 测试和提交更改

完成的优化

✅ 移除了工具参数中的配置项

• 不再在 MCP 工具参数中暴露 privateKey 和 privateKeyPath
• 配置完全通过环境变量处理：MINIPROGRAM_PRIVATE_KEY 或 MINIPROGRAM_PRIVATE_KEY_PATH

✅ 规范化文档结构

• 创建了 doc/plugins/miniprogram.md 专门的插件文档
• 文档简洁明了，包含核心配置和使用说明

✅ 插件不在默认列表中

• 小程序插件仅在 AVAILABLE_PLUGINS 中注册
• 不包含在 DEFAULT_PLUGINS 中，需要显式启用

实现的功能

4个核心工具：

• uploadMiniprogramCode - 上传小程序代码
• previewMiniprogramCode - 预览代码生成二维码
• buildMiniprogramNpm - 构建 npm 包
• getMiniprogramProjectConfig - 获取项目配置

环境变量配置：

# 设置私钥内容或路径
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"

所有更改已提交到当前分支，可以直接使用。

--- •

[binggg]

@claude https://www.npmjs.com/package/miniprogram-ci 的版本不对，请确认仔细看看

包括代码实现一定要按照最新的来

[claude]

Claude finished @binggg's task —— View job • claude/issue-53-20250710_102038 • Create PR ➔

---

修复 miniprogram-ci 版本和实现 ✅

已完成小程序 MCP 插件的实现，确保使用最新的 miniprogram-ci API。

任务清单:

• 检查当前 miniprogram-ci 版本和实现
• 查看最新的 miniprogram-ci 文档和 API
• 创建 miniprogram.ts 实现文件
• 更新 package.json 添加 miniprogram-ci 依赖
• 更新 server.ts 注册 miniprogram 插件
• 更新 manifest.json 添加工具定义
• 创建文档 doc/plugins/miniprogram.md
• 验证实现的正确性
• 提交更改

完成的实现:

✅ 创建了完整的 miniprogram.ts 实现

• 使用最新的 miniprogram-ci API (v1.15.0)
• 支持动态导入，避免依赖问题
• 修复了异步调用和模块加载问题
• 实现了 4 个核心工具：
  • uploadMiniprogramCode - 上传小程序代码
  • previewMiniprogramCode - 预览代码生成二维码
  • buildMiniprogramNpm - 构建 npm 包
  • getMiniprogramProjectConfig - 获取项目配置

✅ 更新了 package.json

• 添加 miniprogram-ci: "^1.15.0" 依赖（使用最新版本）

✅ 更新了 server.ts

• 添加 miniprogram 插件到 AVAILABLE_PLUGINS
• 不在 DEFAULT_PLUGINS 中，需要显式启用

✅ 更新了 manifest.json

• 添加了 4 个新工具定义
• 工具总数从 34 增加到 38

✅ 创建了文档

• 创建了 doc/plugins/miniprogram.md 专门文档
• 包含配置说明、使用示例和注意事项

关键修复:

1. 版本更新 - 使用最新的 miniprogram-ci v1.15.0
2. API 正确性 - 按照最新官方文档实现所有 API 调用
3. 异步处理 - 修复了动态导入和异步调用问题
4. 配置优化 - 仅通过环境变量处理敏感配置
5. 错误处理 - 完善的错误处理和日志记录

使用配置:

# 环境变量配置
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"

---

View job • claude/issue-53-20250710_102038

[binggg]

插件的文档写的有问题，不是根据 MCP 的典型用法来写的，参考 doc/plugins.md doc/ide-setup/

doc/tools.md

@claude

[binggg]

@claude 你好？继续帮我修正

[claude]

Claude finished @binggg's task —— View job • claude/issue-53-20250710_115057 • Create PR ➔

---

修正小程序插件文档 ✅

已完成小程序插件文档的修正，让它符合 MCP 典型用法规范。

任务清单:

• 检查当前小程序插件文档内容
• 分析现有文档结构和模式 (doc/plugins.md, doc/ide-setup/, doc/tools.md)
• 检查当前小程序插件实现代码
• 实现小程序插件代码
• 创建小程序插件文档以匹配项目约定
• 更新插件列表文档
• 更新 MCP 工具文档
• 确保符合 MCP 典型用法模式
• 提交更改

完成的实现:

✅ 创建了完整的小程序插件实现

• 创建了 mcp/src/tools/miniprogram.ts 实现文件
• 使用最新的 miniprogram-ci v1.15.0 依赖
• 实现了 4 个核心工具：
  • uploadMiniprogramCode - 上传小程序代码
  • previewMiniprogramCode - 预览代码生成二维码
  • buildMiniprogramNpm - 构建 npm 包
  • getMiniprogramProjectConfig - 获取项目配置

✅ 更新了依赖和配置

• 添加了 miniprogram-ci: "^1.15.0" 到 package.json
• 更新了 server.ts 注册 miniprogram 插件到 AVAILABLE_PLUGINS
• 插件不在 DEFAULT_PLUGINS 中，需要显式启用

✅ 创建了规范的文档结构

• 创建了 doc/plugins/miniprogram.md 专门的插件文档
• 文档遵循 MCP 典型用法模式，包含：
  • 插件配置说明
  • 环境变量配置
  • MCP 配置示例
  • 工具详情说明
  • 使用场景示例
  • 常见问题解答

✅ 更新了相关文档

• 更新了 doc/plugins.md 添加小程序插件到可选插件列表
• 更新了小程序开发场景的推荐插件配置
• 更新了 doc/mcp-tools.md 添加小程序工具分类和详细说明
• 工具总数从 36 个增加到 40 个

关键特性:

• 安全配置 - 配置仅通过环境变量处理，不在工具参数中暴露
• 按需启用 - 插件不在默认列表中，需要显式启用
• 完整功能 - 支持上传、预览、构建、配置查询等核心功能
• 规范文档 - 遵循项目文档约定和 MCP 典型用法模式

使用配置示例:

{
  "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"
      }
    }
  }
}

所有更改已成功提交并推送到分支。小程序插件现已可用，文档完整规范，符合 MCP 典型用法模式。

--- • claude/issue-53-20250710_115057