@cloudbase/cloudbase-mcp 1.4.2 → 1.6.0

package/README.md

@@ -22,10 +22,15 @@
 [![GitHub last commit](https://img.shields.io/github/last-commit/TencentCloudBase/CloudBase-AI-ToolKit)](https://github.com/TencentCloudBase/CloudBase-AI-ToolKit/commits)
 [![GitHub contributors](https://img.shields.io/github/contributors/TencentCloudBase/CloudBase-AI-ToolKit)](https://github.com/TencentCloudBase/CloudBase-AI-ToolKit/graphs/contributors)
 
+
+[![CNB 镜像](https://img.shields.io/badge/CNB-CloudBase--AI--ToolKit-blue?logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTIiIGhlaWdodD0iMTIiIHZpZXdCb3g9IjAgMCAxMiAxMiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj48cmVjdCB3aWR0aD0iMTIiIGhlaWdodD0iMTIiIHJ4PSIyIiBmaWxsPSIjM0I4MkY2Ii8+PHBhdGggZD0iTTUgM0g3VjVINSIgc3Ryb2tlPSJ3aGl0ZSIgc3Ryb2tlLXdpZHRoPSIxLjUiLz48cGF0aCBkPSJNNSA3SDdWOUg1IiBzdHJva2U9IndoaXRlIiBzdHJva2Utd2lkdGg9IjEuNSIvPjwvc3ZnPg==)](https://cnb.cool/tencent/cloud/cloudbase/CloudBase-AI-ToolKit)
+
 当你在**Cursor/ VSCode GitHub Copilot/WinSurf/CodeBuddy**等AI编程工具里写代码时，它能自动帮你生成可直接部署的前后端应用+小程序，并一键发布到腾讯云开发 CloudBase。
 
 <a href="https://www.producthunt.com/posts/cloudbase-ai-tookit?embed=true&utm_source=badge-featured&utm_medium=badge&utm_source=badge-cloudbase&#0045;ai&#0045;tookit" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=971451&theme=light&t=1748519563832" alt="CloudBase&#0032;AI&#0032;Tookit - Prompt&#0032;to&#0032;Production&#0058;&#0032;Full&#0045;stack&#0044;&#0032;DB&#0032;&#0038;&#0032;functions—zero&#0032;setup&#0046; | Product Hunt" style="width: 250px; height: 54px;" width="250" height="54" /></a>
 
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=CloudBase&config=eyJjb21tYW5kIjoibnB4IEBjbG91ZGJhc2UvY2xvdWRiYXNlLW1jcEBsYXRlc3QiLCJlbnYiOnsiQ0xPVURCQVNFX0VOVl9JRCI6IllPVVJfRU5WX0lEIn0sImRpc2FibGVkIjpmYWxzZX0%3D)
+
 
 
 ### 🚀 三大核心能力
@@ -51,12 +56,13 @@ https://github.com/user-attachments/assets/2b402fa6-c5c4-495a-b85b-f5d4a25daa4a
 | **📱 全栈应用支持** | Web + 小程序 + 数据库 + 后端一体化 | 支持小程序/web 等多种应用形式,提供后端托管和数据库 |
 | **🔧 智能修复** | AI 自动查看日志并修复问题 | 降低运维成本 |
 | **⚡ 极速体验** | 国内 CDN 加速 | 比海外平台访问速度更快 |
+| **📚 智能知识库检索** | 内置支持云开发、微信小程序等专业知识库的智能向量检索 |
 
 
 ## 🚀 快速开始
 
 
-### 0.前置条件
+### 0. 前置条件
 
 #### 安装 AI 开发工具
 例如 [Cursor](https://www.cursor.com/) | [WindSurf](https://windsurf.com/editor) | [CodeBuddy](https://copilot.tencent.com/) 等
@@ -66,29 +72,48 @@ https://github.com/user-attachments/assets/2b402fa6-c5c4-495a-b85b-f5d4a25daa4a
 2. 在控制台「概览」页面右侧获取 **环境ID**  
    （后续部署需要此 ID）
 
-### 1. 使用模板创建项目
+### 1. 快速初始化或增强你的项目
+
+我们为你准备了内置云开发最佳实践和 AI IDE 规则的项目模板，推荐如下两种方式：
+
+#### 🚀 新项目推荐
+
+选择适合你的模板，一键初始化：
+
+- **React Web 应用 + 云开发模板**  
+  [下载代码包](https://static.cloudbase.net/cloudbase-examples/web-cloudbase-react-template.zip?v=2025053001) ｜ [开源代码地址](https://github.com/TencentCloudBase/awesome-cloudbase-examples/tree/master/web/cloudbase-react-template)
+
+- **微信小程序 + 云开发模板**  
+  [下载代码包](https://static.cloudbase.net/cloudbase-examples/miniprogram-cloudbase-miniprogram-template.zip?v=2025053001) ｜ [开源代码地址](https://github.com/TencentCloudBase/awesome-cloudbase-examples/tree/master/miniprogram/cloudbase-miniprogram-template)
+
+- **通用云开发模板**  
+  [下载代码包](https://static.cloudbase.net/cloudbase-examples/web-cloudbase-project.zip) ｜ [开源代码地址](https://github.com/TencentCloudBase/awesome-cloudbase-examples/tree/master/web/cloudbase-project)
 
-以下模板已经内置了云开发面向 AI IDE 的规则配置
+#### 🛠️ 已有项目增强
 
-建议选择适合你的项目模板快速开始：
+如果你已经有自己的项目，只需在配置好 MCP 后，让 AI 调用 `downloadTemplate` 工具，选择 `rules` 模板，即可一键下载并补全 AI 编辑器规则配置到当前项目目录，无需手动操作。
 
-- React Web应用+云开发模板：[下载代码包](https://static.cloudbase.net/cloudbase-examples/web-cloudbase-react-template.zip?v=2025053001) ｜ [开源代码地址](https://github.com/TencentCloudBase/awesome-cloudbase-examples/tree/master/web/cloudbase-react-template)
-- 小程序+云开发模板：[下载代码包](https://static.cloudbase.net/cloudbase-examples/miniprogram-cloudbase-miniprogram-template.zip?v=2025053001) ｜ [开源代码地址](https://github.com/TencentCloudBase/awesome-cloudbase-examples/tree/master/miniprogram/cloudbase-miniprogram-template)
 
 ### 2. 配置你的 AI IDE
 
+> 💡 **使用提示**：如果你在 Cursor 等工具中开启了自动执行(auto-run)模式，建议在"Command denylist"中添加敏感命令，避免自动运行如删除数据等敏感的操作
+> 
+> 默认模式下需要手动确认执行，较为安全。
+
 以下工具均支持 CloudBase AI ToolKit，可根据你的开发环境选择合适的工具：
 
 | 工具 | 支持平台 |
 |------|----------|
 | [Cursor](https://cursor.com/) | 独立 IDE|
 | [WindSurf](https://windsurf.com/editor) | 独立 IDE,VSCode、JetBrains 插件 |
-| [CodeBuddy](https://copilot.tencent.com/) | VS Code, JetBrains、微信开发者工具插件 |
+| [CodeBuddy](https://copilot.tencent.com/) | VS Code、JetBrains、微信开发者工具插件 |
 | [CLINE](https://cline.so/) | VS Code 插件 |
 | [GitHub Copilot](https://github.com/features/copilot) | VS Code 插件 |
 | [Trae](https://www.trae.ai/) | 独立 IDE |
-| [通义灵码](https://tongyi.aliyun.com/lingma) | 独立 IDE，VS Code, JetBrains插件 |
+| [通义灵码](https://tongyi.aliyun.com/lingma) | 独立 IDE，VS Code、 JetBrains插件 |
 | [RooCode](https://roocode.com/) | VS Code插件 |
+| [文心快码](https://comate.baidu.com/) | VS Code、JetBrains插件|
+
 
 选择工具后，请按照下方对应的配置说明进行设置。每个工具都需要配置云开发环境 ID 才能使用 MCP 功能。如果你还没有云开发环境，请先[开通云开发环境](#0前置条件)。
 
@@ -102,6 +127,10 @@ https://github.com/user-attachments/assets/2b402fa6-c5c4-495a-b85b-f5d4a25daa4a
 
 #### 步骤2：配置 MCP
 
+模板中已经包含 mcp 配置，如果不是从模板开始，可以点击下方按钮安装到 Cursor 中
+
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=CloudBase&config=eyJjb21tYW5kIjoibnB4IEBjbG91ZGJhc2UvY2xvdWRiYXNlLW1jcEBsYXRlc3QiLCJlbnYiOnsiQ0xPVURCQVNFX0VOVl9JRCI6IllPVVJfRU5WX0lEIn0sImRpc2FibGVkIjpmYWxzZX0%3D)
+
 1. 请修改项目中的 `.cursor/mcp.json` ，填写你的云开发环境 ID
 
 ```json
@@ -399,6 +428,46 @@ https://github.com/user-attachments/assets/2b402fa6-c5c4-495a-b85b-f5d4a25daa4a
 
 </details>
 
+<details>
+<summary><strong>🤖 文心快码(Baidu Comate) 配置</strong></summary>
+
+#### 步骤1：自动应用 AI 规则
+
+模板中已包含 `.comate/rules` 目录，文心快码会自动识别云开发最佳实践
+
+#### 步骤2：配置 MCP 
+
+模板中已包含 `.comate/mcp.json` 目录，文心快码会自动识别项目中的 MCP
+
+**配置云开发 MCP Server**
+
+在文心快码的 Zulu 模式中，选择 MCP 配置-设置，在打开的文件中修改 MCP 配置
+
+其中 CLOUDBASE_ENV_ID 填写你的云开发环境 ID
+
+```json
+{
+    "mcpServers": {
+        "cloudbase": {
+            "command": "npx",
+            "args": [
+                "@cloudbase/cloudbase-mcp@latest"
+            ],
+            "env": {
+                "CLOUDBASE_ENV_ID": "你的云开发环境ID"
+            },
+            "disabled": false
+        }
+    }
+}
+```
+
+#### 步骤3：使用 AI 对话
+
+在对话窗口中切换到 Zulu 模式，然后使用 AI 进行代码生成和自动化操作
+
+</details>
+
 ### 3. 开始开发
 
 确认 AI 已经连接到云开发
@@ -505,11 +574,57 @@ AI 会自动：
 
 ---
 
+## 🌟 为什么选择 CloudBase？
+
+- **⚡ 极速部署**：国内节点,访问速度比海外更快
+- **🛡️ 稳定可靠**：330 万开发者选择的 Serverless 平台
+- **🔧 开发友好**：专为AI时代设计的全栈平台
+- **💰 成本优化**：Serverless 架构更具弹性，新用户开发期间可以免费体验
+
+
+## 📋 常见问题 FAQ
+
+如有迁移、集成等常见疑问，请查阅 [FAQ 常见问题](./FAQ.md)。 
+
+## 💬 技术交流群
+
+遇到问题或想要交流经验？加入我们的技术社区！
+
+### 🔥 微信交流群
+
+<div align="center">
+<img src="https://7463-tcb-advanced-a656fc-1257967285.tcb.qcloud.la/mcp/toolkit-qrcode.png" width="200" alt="微信群二维码">
+<br>
+<i>扫码加入微信技术交流群</i>
+</div>
+
+**群内你可以：**
+- 💡 分享你的 AI + 云开发项目
+- 🤝 技术交流和开发问题沟通
+- 📢 获取最新功能更新和最佳实践
+- 🎯 参与产品功能讨论和建议
+
+### 📱 其他交流方式
+
+| 平台 | 链接 | 说明 |
+|------|------|------|
+| **官方文档** | [📖 查看文档](https://docs.cloudbase.net/) | 完整的云开发文档 |
+| **Issue 反馈** | [🐛 提交问题](https://github.com/TencentCloudBase/CloudBase-AI-ToolKit/issues) | Bug 反馈和功能请求 |
+
+### 🎉 社区活动
+
+- **每周技术分享**：群内定期分享 AI + 云开发最佳实践
+- **项目展示**：展示你用 AI 开发的精彩项目
+- **问题答疑**：腾讯云开发团队成员在线答疑
+- **新功能预览**：第一时间体验最新功能
+
+
 ## 🛠️ 云开发 MCP 工具一览
 
 | 工具名称 | 功能简介 |
 |----------|----------|
 | logout | 登出当前云开发账户 |
+| downloadTemplate | 下载CloudBase项目模板（React、小程序、AI编辑器配置等） |
 | listEnvs | 获取所有云开发环境信息 |
 | getEnvAuthDomains | 获取云开发环境的合法域名列表 |
 | createEnvDomain | 为云开发环境添加安全域名 |
@@ -547,7 +662,7 @@ AI 会自动：
 | deleteFunctionTrigger | 删除云函数触发器 |
 | downloadRemoteFile | 下载远程文件到本地临时文件 |
 | uploadFile | 上传文件到云存储（适合存储业务数据文件） |
-| search_knowledge_base | 智能检索云开发知识库（支持云开发与云函数），通过向量搜索快速获取专业文档与答案。|
+| searchKnowledgeBase | 智能检索云开发知识库（支持云开发与云函数），通过向量搜索快速获取专业文档与答案。|
 
 ## 🏗️ 架构原理
 
@@ -566,45 +681,6 @@ graph TD
     J --> K[Web/小程序/API]
 ```
 
-## 🌟 为什么选择 CloudBase？
-
-- **⚡ 极速部署**：国内节点,访问速度比海外更快
-- **🛡️ 稳定可靠**：330 万开发者选择的 Serverless 平台
-- **🔧 开发友好**：专为AI时代设计的全栈平台
-- **💰 成本优化**：Serverless 架构更具弹性，新用户开发期间可以免费体验
-
-## 💬 技术交流群
-
-遇到问题或想要交流经验？加入我们的技术社区！
-
-### 🔥 微信交流群
-
-<div align="center">
-<img src="https://7463-tcb-advanced-a656fc-1257967285.tcb.qcloud.la/mcp/toolkit-qrcode.png" width="200" alt="微信群二维码">
-<br>
-<i>扫码加入微信技术交流群</i>
-</div>
-
-**群内你可以：**
-- 💡 分享你的 AI + 云开发项目
-- 🤝 技术交流和开发问题沟通
-- 📢 获取最新功能更新和最佳实践
-- 🎯 参与产品功能讨论和建议
-
-### 📱 其他交流方式
-
-| 平台 | 链接 | 说明 |
-|------|------|------|
-| **官方文档** | [📖 查看文档](https://docs.cloudbase.net/) | 完整的云开发文档 |
-| **Issue 反馈** | [🐛 提交问题](https://github.com/TencentCloudBase/CloudBase-AI-ToolKit/issues) | Bug 反馈和功能请求 |
-
-### 🎉 社区活动
-
-- **每周技术分享**：群内定期分享 AI + 云开发最佳实践
-- **项目展示**：展示你用 AI 开发的精彩项目
-- **问题答疑**：腾讯云开发团队成员在线答疑
-- **新功能预览**：第一时间体验最新功能
-
 ## 🤝 贡献指南
 
 欢迎提交 Issue 和 Pull Request！请查看我们的[贡献指南](CONTRIBUTING.md)了解如何参与项目开发。
@@ -617,6 +693,3 @@ graph TD
 
 ⭐ 如果这个项目对你有帮助，请给我们一个 Star！ 
 
-## 📋 [常见问题 FAQ](./FAQ.md)
-
-如有迁移、集成等常见疑问，请查阅 [FAQ 常见问题](./FAQ.md)。 

package/dist/index.js

@@ -8,6 +8,7 @@ import { registerHostingTools } from "./tools/hosting.js";
 import { registerDownloadTools } from "./tools/download.js";
 import { registerStorageTools } from "./tools/storage.js";
 import { registerRagTools } from './tools/rag.js';
+import { registerSetupTools } from "./tools/setup.js";
 // Create server instance
 const server = new McpServer({
     name: "cloudbase-mcp",
@@ -33,10 +34,12 @@ registerFunctionTools(server);
 registerDownloadTools(server);
 // Register storage tools
 registerStorageTools(server);
+// Register setup tools
+registerSetupTools(server);
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error("TencentCloudBase MCP Server running on stdio");
+    console.log("TencentCloudBase MCP Server running on stdio");
 }
 main().catch((error) => {
     console.error("Fatal error in main():", error);

package/dist/tools/functions.js

@@ -1,5 +1,15 @@
 import { z } from "zod";
 import { getCloudBaseManager } from '../cloudbase-manager.js';
+// 支持的 Node.js 运行时列表
+export const SUPPORTED_NODEJS_RUNTIMES = [
+    'Nodejs 18.15',
+    'Nodejs 16.13',
+    'Nodejs 14.18',
+    'Nodejs 12.16',
+    'Nodejs 10.15',
+    'Nodejs 8.9（即将下线）',
+];
+export const DEFAULT_NODEJS_RUNTIME = 'Nodejs 18.15';
 export function registerFunctionTools(server) {
     // getFunctionList - 获取云函数列表(推荐)
     server.tool("getFunctionList", "获取云函数列表", {
@@ -27,7 +37,7 @@ export function registerFunctionTools(server) {
                 vpcId: z.string(),
                 subnetId: z.string()
             }).optional().describe("私有网络配置"),
-            runtime: z.string().optional().describe("运行时环境"),
+            runtime: z.string().optional().describe("运行时环境，可选值：" + SUPPORTED_NODEJS_RUNTIMES.join('，') + "，默认 Nodejs 18.15"),
             installDependency: z.boolean().optional().describe("是否安装依赖，建议传 true"),
             triggers: z.array(z.object({
                 name: z.string(),
@@ -45,6 +55,10 @@ export function registerFunctionTools(server) {
         functionRootPath: z.string().optional().describe("函数根目录（云函数目录的父目录），这里需要传操作系统上文件的绝对路径，指定之后可以自动上传这部分的文件作为代码"),
         force: z.boolean().describe("是否覆盖")
     }, async ({ func, functionRootPath, force }) => {
+        // 自动填充默认 runtime
+        if (!func.runtime) {
+            func.runtime = DEFAULT_NODEJS_RUNTIME;
+        }
         const cloudbase = await getCloudBaseManager();
         const result = await cloudbase.functions.createFunction({
             func,
@@ -94,9 +108,13 @@ export function registerFunctionTools(server) {
                 vpcId: z.string(),
                 subnetId: z.string()
             }).optional().describe("VPC配置"),
-            runtime: z.string().optional().describe("运行时")
+            runtime: z.string().optional().describe("运行时（可选值：" + SUPPORTED_NODEJS_RUNTIMES.join('，') + "，默认 Nodejs 18.15)")
         }).describe("函数配置")
     }, async ({ funcParam }) => {
+        // 自动填充默认 runtime
+        if (!funcParam.runtime) {
+            funcParam.runtime = DEFAULT_NODEJS_RUNTIME;
+        }
         const cloudbase = await getCloudBaseManager();
         const result = await cloudbase.functions.updateFunctionConfig(funcParam);
         return {

package/dist/tools/rag.js

@@ -1,10 +1,11 @@
 import { z } from "zod";
 // 1. 枚举定义
-const KnowledgeBaseEnum = z.enum(["cloudbase", "scf"]);
+const KnowledgeBaseEnum = z.enum(["cloudbase", "scf", "miniprogram"]);
 // 2. 枚举到后端 id 的映射
 const KnowledgeBaseIdMap = {
     cloudbase: "ykfzskv4_ad28",
     scf: "scfsczskzyws_4bdc",
+    miniprogram: "xcxzskws_25d8",
 };
 // 安全 JSON.parse
 function safeParse(str) {
@@ -34,9 +35,9 @@ function safeStringify(obj) {
 }
 export function registerRagTools(server) {
     // 知识库检索
-    server.tool('search_knowledge_base', '云开发知识库智能检索工具，支持云开发与云函数知识的向量查询', {
+    server.tool('searchKnowledgeBase', '云开发知识库智能检索工具，支持云开发与云函数知识的向量查询', {
         threshold: z.number().default(0.5).optional().describe("相似性检索阈值"),
-        id: KnowledgeBaseEnum.describe("知识库范围，cloudbase=云开发全量知识，scf=云开发的云函数知识"),
+        id: KnowledgeBaseEnum.describe("知识库范围，cloudbase=云开发全量知识，scf=云开发的云函数知识, miniprogram=小程序知识（不包含云开发与云函数知识）"),
         content: z.string().describe("检索内容"),
         options: z.object({
             chunkExpand: z.array(z.number()).min(2).max(2).default([3, 3]).describe("指定返回的文档内容的展开长度,例如 [3,3]代表前后展开长度"),

package/dist/tools/setup.js

@@ -0,0 +1,186 @@
+import { z } from "zod";
+import * as fs from "fs";
+import * as fsPromises from "fs/promises";
+import * as path from "path";
+import * as os from "os";
+import * as https from "https";
+import * as http from "http";
+import * as unzipper from "unzipper";
+// CloudBase 模板配置
+const TEMPLATES = {
+    "react": {
+        description: "React + CloudBase 全栈应用模板",
+        url: "https://static.cloudbase.net/cloudbase-examples/web-cloudbase-react-template.zip"
+    },
+    "miniprogram": {
+        description: "微信小程序 + 云开发模板",
+        url: "https://static.cloudbase.net/cloudbase-examples/miniprogram-cloudbase-miniprogram-template.zip"
+    },
+    "rules": {
+        description: "AI编辑器配置模板（包含所有主流编辑器配置）",
+        url: "https://static.cloudbase.net/cloudbase-examples/web-cloudbase-project.zip"
+    }
+};
+// 下载文件到临时目录
+async function downloadFile(url, filePath) {
+    return new Promise((resolve, reject) => {
+        const client = url.startsWith('https:') ? https : http;
+        client.get(url, (res) => {
+            if (res.statusCode === 200) {
+                const file = fs.createWriteStream(filePath);
+                res.pipe(file);
+                file.on('finish', () => {
+                    file.close();
+                    resolve();
+                });
+                file.on('error', reject);
+            }
+            else if (res.statusCode === 302 || res.statusCode === 301) {
+                // 处理重定向
+                if (res.headers.location) {
+                    downloadFile(res.headers.location, filePath).then(resolve).catch(reject);
+                }
+                else {
+                    reject(new Error('重定向但没有location header'));
+                }
+            }
+            else {
+                reject(new Error(`下载失败，状态码: ${res.statusCode}`));
+            }
+        }).on('error', reject);
+    });
+}
+// 解压ZIP文件
+async function extractZip(zipPath, extractPath) {
+    try {
+        // 创建解压目录
+        await fsPromises.mkdir(extractPath, { recursive: true });
+        // 使用 unzipper 库进行解压，兼容性更好
+        await fs.createReadStream(zipPath)
+            .pipe(unzipper.Extract({ path: extractPath }))
+            .promise();
+    }
+    catch (error) {
+        throw new Error(`解压失败: ${error instanceof Error ? error.message : '未知错误'}`);
+    }
+}
+// 获取目录下所有文件的相对路径列表
+async function getAllFiles(dir, baseDir = dir) {
+    const files = [];
+    const entries = await fsPromises.readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            const subFiles = await getAllFiles(fullPath, baseDir);
+            files.push(...subFiles);
+        }
+        else {
+            files.push(path.relative(baseDir, fullPath));
+        }
+    }
+    return files;
+}
+// 复制文件，不覆盖已存在的文件
+async function copyFileIfNotExists(src, dest) {
+    try {
+        // 检查目标文件是否存在
+        if (fs.existsSync(dest)) {
+            return { copied: false, reason: '文件已存在' };
+        }
+        // 创建目标目录
+        await fsPromises.mkdir(path.dirname(dest), { recursive: true });
+        // 复制文件
+        await fsPromises.copyFile(src, dest);
+        return { copied: true };
+    }
+    catch (error) {
+        return { copied: false, reason: `复制失败: ${error instanceof Error ? error.message : '未知错误'}` };
+    }
+}
+export function registerSetupTools(server) {
+    server.tool("downloadTemplate", `自动下载并部署CloudBase项目模板。
+
+支持的模板:
+- react: React + CloudBase 全栈应用模板
+- miniprogram: 微信小程序 + 云开发模板  
+- rules: 只包含AI编辑器配置文件（包含Cursor、WindSurf、CodeBuddy等所有主流编辑器配置），适合在已有项目中补充AI编辑器配置
+
+工具会自动下载模板到临时目录，解压后如果检测到WORKSPACE_FOLDER_PATHS环境变量，则复制到项目目录（不覆盖已存在文件）。`, {
+        template: z.enum(["react", "miniprogram", "rules"]).describe("要下载的模板类型")
+    }, async ({ template }) => {
+        try {
+            const templateConfig = TEMPLATES[template];
+            if (!templateConfig) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `❌ 不支持的模板类型: ${template}`
+                        }
+                    ]
+                };
+            }
+            // 创建临时目录
+            const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cloudbase-template-'));
+            const zipPath = path.join(tempDir, 'template.zip');
+            const extractDir = path.join(tempDir, 'extracted');
+            // 下载和解压
+            await downloadFile(templateConfig.url, zipPath);
+            await extractZip(zipPath, extractDir);
+            const extractedFiles = await getAllFiles(extractDir);
+            // 检查是否需要复制到项目目录
+            const workspaceFolder = process.env.WORKSPACE_FOLDER_PATHS;
+            let finalFiles = [];
+            let copiedCount = 0;
+            let skippedCount = 0;
+            const results = [];
+            if (workspaceFolder) {
+                for (const relativePath of extractedFiles) {
+                    const srcPath = path.join(extractDir, relativePath);
+                    const destPath = path.join(workspaceFolder, relativePath);
+                    const copyResult = await copyFileIfNotExists(srcPath, destPath);
+                    if (copyResult.copied) {
+                        copiedCount++;
+                        finalFiles.push(destPath);
+                    }
+                    else {
+                        skippedCount++;
+                        finalFiles.push(srcPath);
+                    }
+                }
+                results.push(`✅ ${templateConfig.description} 同步完成`);
+                results.push(`📁 保存在临时目录: ${extractDir}`);
+                results.push(`📊 复制了 ${copiedCount} 个文件${skippedCount > 0 ? `，跳过 ${skippedCount} 个已存在文件` : ''}`);
+            }
+            else {
+                finalFiles = extractedFiles.map(relativePath => path.join(extractDir, relativePath));
+                results.push(`✅ ${templateConfig.description} 下载完成`);
+                results.push(`📁 保存在临时目录: ${extractDir}`);
+            }
+            // 文件路径列表
+            results.push('');
+            results.push('📋 文件列表:');
+            finalFiles.forEach(filePath => {
+                results.push(`${filePath}`);
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: results.join('\n')
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `❌ 下载模板失败: ${error instanceof Error ? error.message : '未知错误'}`
+                    }
+                ]
+            };
+        }
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudbase/cloudbase-mcp",
-  "version": "1.4.2",
+  "version": "1.6.0",
   "description": "腾讯云开发 MCP Server，支持静态托管/环境查询/",
   "main": "index.js",
   "type": "module",
@@ -29,6 +29,8 @@
     "@cloudbase/mcp": "^1.0.0-beta.25",
     "@cloudbase/toolbox": "^0.7.5",
     "@modelcontextprotocol/sdk": "1.9.0",
+    "@types/unzipper": "^0.10.11",
+    "unzipper": "^0.12.3",
     "zod": "^3.24.3"
   },
   "devDependencies": {