CloudBase MCP v2.17.1

CloudBase MCP v2.17.1

🐛 问题修复

• 修复 mcp-tools 文档在 MDX 场景下的转义与构建问题，降低文档发布失败概率。
• 移除旧版环境引导中的 legacy guide prompt injection，减少环境相关误导与错误路由。
• 补充云函数触发器 cron 与 functionRootPath 的生成文档说明，减少常见配置误用。

✨ 能力与体验优化

• 收敛 CloudBase 入口层规则：默认前置失败切换原则，并要求在代码、配置、命令示例中显式指定 EnvId。
• 升级 mcp/ 中的 @cloudbase/toolbox 到 0.7.20，与最新 Manager 侧能力保持同步。
• 补齐 ops-inspector 相关兼容基线与规则覆盖，改善配套体验。

📚 规则与文档更新

• 更新本地 Git 工作流约定：默认仅推荐 git push github，不再默认推荐 cnb 推送。
• 收紧 MCP 工具设计约定：对低价值 alias tool 增长增加约束，优先复用现有统一入口。

🔧 维护与工程改进（可选阅读）

• 同步 CloudBase skills 版本到 2.17.1。
• 更新构建生成的工具文档与工具清单产物。

CloudBase MCP v2.17.0

CloudBase MCP v2.17.0

🎉 新功能

文档与知识检索

• searchKnowledgeBase 新增 CloudBase 官方文档 docs 模式，并把官方文档检索整合进统一入口，检索路径更直接。
• 文档检索能力与技能说明进一步收敛，减少在固定技能文档、OpenAPI 与官方文档之间来回切换的成本。

应用认证与权限能力

• 应用认证工具补齐了 publishable key、API key、自定义登录密钥、provider / client 配置等能力，方便在 AI IDE 中直接完成认证准备工作。
• 扩展了 manager-node 5.1 相关的认证与工作流支持，应用认证、权限与环境配置链路更完整。

技能与配置体系

• 新增和整理了一批对外 skills 与配置目录，提升多 IDE / 多场景下的能力发现与复用体验。
• 增强了对外规则与 skill 的来源回退与发布一致性，降低规则缺失或链接失效带来的使用摩擦。

🐛 问题修复

• 修复 searchKnowledgeBase 在官方文档 docs 模式下的登录限制，未登录场景也能正常检索文档。
• 修复环境地域与静态域名相关回退逻辑，减少环境查询和托管配置场景下的误判。
• 修复应用认证工具在 action 对齐、ensure 流程与返回提示上的多个问题，降低认证配置出错率。
• 修复 NoSQL 安全规则说明与资源类型边界，避免把数据库规则误用于函数或存储。
• 修复技能发布中的 ClawHub slug、产物路径与版本同步问题，提升对外发布稳定性。

📚 文档更新

• 补充函数与云存储安全规则引用，帮助在配置权限时更快找到正确文档。
• 清理公开文档链接与部分重复的 CloudBase 指南内容，减少阅读噪音。
• 更新 MCP 工具说明和生成文档，让工具描述与当前实现保持一致。

🔧 维护与工程改进（可选阅读）

• 持续收敛 issue auto-processor、skills mirror、all-in-one 版本同步等维护链路。
• 优化部分发布、校验与自动化流程，为后续版本发布与规则同步提供更稳定的基础。

CloudBase MCP v2.16.1

CloudBase MCP v2.16.1

🎉 重点升级

1. MCP 工具模块更完整了

这一版最值得强调的，不是零散修补，而是 工具模块覆盖面明显扩大。

• 应用认证工具模块：新增 queryAppAuth / manageAppAuth
  • 可以直接查询和管理登录方式、provider、client 配置、publishable key、静态域名等应用认证配置
• 权限治理工具模块：新增 queryPermissions / managePermissions
  • 可以统一处理资源权限、角色、应用用户等权限治理能力
• CloudApp 管理工具模块：新增 queryApps / manageApps
  • 支持应用列表、版本查询，以及静态部署、删除应用、删除版本等操作
• 日志检索工具模块：新增 queryLogs
  • 可以检查日志服务状态并直接检索 CLS 日志
• Agent 管理工具模块：新增 queryAgents / manageAgents
  • 补齐 Agent 的查询、日志查看、创建、更新、删除等入口

2. 工具路由和底层能力更统一

• Manager SDK v5 升级：MCP 底层升级到 Manager SDK v5，为新工具模块和统一权限能力打基础
• 权限与认证入口梳理：把原本分散、容易混淆的权限/认证能力整理得更清晰，应用认证相关指引会更稳定地路由到对应工具

3. 数据库和网关体验更顺手

• MySQL 实例未找到提示优化：当实例不存在时，给出更可执行的提示，而不是只返回模糊报错
• NoSQL 索引入口更明显：NoSQL 结构工具里更明确暴露索引查询、添加、删除入口，降低“功能有但找不到”的问题
• NoSQL 嵌套字段更新指引补强：补充点路径更新语义说明，减少误用风险
• 网关函数类型说明优化：创建 HTTP 访问入口时，对函数类型参数的说明更清楚，减少配置失败
• CloudRun 边界修复：修复命令变量引用和根路径校验的边界问题

🐛 问题修复

• 修复调试类型不匹配问题，移除重复的 toJSONString
• 修复命令注入、路径遍历、凭证日志记录和 IPv4 溢出等安全问题
• 修复运行时验证与测试稳定性问题，减少“静默跳过”带来的不确定性
• 修复技能版本同步流程中的边界问题

📚 文档与提示词改进

• 优化 SQL / Cloud API 相关指引，降低工具选择成本
• 简化技能提示页内容，让入口更聚焦
• 恢复 AI 对话安装命令中的 -y 提示，减少用户卡在交互确认上的情况
• 补充两篇 CloudBase 历史文章与相关文档内容

🔧 维护与工程改进（可选阅读）

下面这些不是本次对外发布的重点能力，更多属于工程建设：

• 新增 codebase-audit 技能：支持端到端代码审查、问题创建和基于 worktree 的 PR 工作流
• 为 codebase-audit 增加依赖漏洞审计能力
• 清理测试文件和冗余 tgz 包
• 移除 miniprogram-ci 及相关死代码，消除 54 个安全漏洞
• 更新兼容基线，优化技能合约和路由边界
• 优化 CI 流程，支持 main 分支变更自动同步到示例项目
• 改进发布测试门控与整体工程稳定性
• 更新 README banner 和部分构建、脚本细节

CloudBase MCP v2.15.4

CloudBase MCP v2.15.4

🐛 问题修复

• 修复 readNoSqlDatabaseContent 的 sort 参数与后端 QueryRecords 契约不一致的问题。
• 现在 sort 只接受后端真实支持的数组结构，非法对象写法会在工具层提前拦截，避免请求打到后端后才报错。

📚 文档更新

• 同步更新工具元数据与文档说明，明确 sort 的输入格式和版本信息。

🔧 维护与工程改进（可选阅读）

• 增加了 main 分支发版工作流，方便后续 patch/minor 版本发布。

CloudBase MCP v2.15.3

CloudBase MCP v2.15.3

本次 Release 汇总了 v2.11.1 到 v2.15.3 的用户侧改进与修复，并对常见接入与排障路径做了更清晰的指引。

🎉 新功能

☁️ 云函数（Cloud Functions）

• 更清晰地区分与指导 HTTP 云函数 vs Event 云函数 的编写模式与使用方式。
• 新增 云函数代码下载链接能力，便于快速获取现网代码产物进行审阅与排障。
• 强化 HTTP 云函数相关流程指引，使创建/部署/访问路径等环节更顺畅。

🔐 身份认证（Auth）

• 认证入口能力整合：统一 login/logout 等流程，缩短成功路径，并强化失败时的下一步引导。
• 支持 自定义 Device Flow 端点等配置场景，适配更多企业/私有化认证接入方式。
• Web 侧认证接入补齐：完善 Web SDK 调用链路与表单衔接，降低接入成本。
• 环境初始化/认证配置流程工具化：减少不必要的对外交互细节，让配置体验更连贯。

🧰 环境管理（Env）

• envQuery 能力增强：支持更精确的筛选与更聚焦的输出，并补充认证候选信息汇总。
• 环境信息更完整：补充计费/账单相关字段与关键限制说明，减少信息不足导致的误判。
• 托管信息更可用：补齐 CDN/Bucket 等信息，并对“配置生效存在传播延迟”给出明确提示。

🗄️ 数据库

• MySQL 管理能力升级：重构 MySQL 工具的生命周期与返回结构，并新增/完善销毁（destroy）能力，使创建/查询/销毁更可靠。
• NoSQL 输出更结构化：集合级别的返回更统一，便于后续自动化处理与解析。

🐛 问题修复

☁️ 云函数与网关

• 修复/强化 HTTP 云函数常见问题处理与引导（依赖安装、访问路径、匿名访问提示、传播等待建议等），减少“刚配完就不通/不知道下一步”的情况。
• 网关访问提示更贴近真实传播行为，降低因延迟造成的误判。

🔐 认证

• 修复自定义端点配置默认值与参数映射对齐问题，降低接入自定义 OAuth/Device Flow 的踩坑概率。
• 修订认证配置示例，移除只读字段等容易导致配置失败的内容。

🗄️ MySQL

• 修复生命周期状态映射、参数对齐、返回解析与轮询逻辑等问题，提高流程稳定性。

🧠 RAG / 知识库

• 修复默认知识库选择与检索参数命名对齐问题，减少“参数不生效/检索不符合预期”的情况。

🧰 工具体验

• 多处工具描述与错误提示增强：对常见失败场景给出更明确的下一步行动建议（例如权限不足时的安全规则修复路径等）。

📚 文档与使用体验

• Cloud API / 控制面 action 指引更清晰，减少调用方式混淆。
• envQuery 字段、限制与示例补充完善。
• Web SDK 获取与引用方式更前置可见，降低 Web 项目接入成本。
• 多处 rules / skills / prompts 相关说明更新，保持指引一致性。

🔧 维护与工程改进（可选阅读）

• Skills 工程化与一致性：新增 manage-local-skills、attribution repair loop 等流程与文档，提升多 IDE/Agent 场景下的执行一致性。
• 发布自动化与工作流完善：补充 registry 发布/同步相关工作流，增强发布编排与稳定性。

CloudBase MCP v2.11.1

CloudBase MCP v2.11.1

🎉 新功能

开发体验

• 交互式环境选择页支持在 Cloud IDE、远程 VS Code 等远程环境中正常使用。
• 新增 CloudBase Agent TS 相关技能，便于基于 TypeScript 开发与对接 Agent。

---

🐛 问题修复

登录与环境选择

• 远程环境：修复在远程 VS Code / Cloud IDE 中打开环境选择页时 WebSocket 无法连接的问题（改为与页面同 host，不再使用 localhost）。
• 长时间操作：修复登录或切换账号时连接容易断开的问题，长时间操作下连接更稳定。

配置与解析

• 修正 sort 字段说明，避免误用。
• 修复部分 YAML 配置因 description 格式导致的解析错误。

---

📚 文档更新

• 更新 CodeBuddy 中 CloudBase MCP 的文档链接。

---

🔧 其他改进

• 优化 All-in-One 技能的构建与路径解析逻辑。

CloudBase MCP v2.10.0

主要更新

CloudBase Skills 正式发布

• 一键安装：运行 npx skills add tencentcloudbase/skills 即可安装 CloudBase 开发技能，AI 可直接使用云开发能力。

身份认证 Skills 更新

• 身份认证相关 Skills 已对齐最新 Web SDK，AI 使用登录、注册等能力更准确、更友好。

MCP 远程托管与地域

• 正式支持远程托管 MCP：通过配置 URL 即可连接，无需本地起 MCP 服务，更适合团队与云端使用。
• 支持切换地域：可按需选择云开发环境所在地域，连接更稳定。

MCP 文档型数据库

• 文档型数据库工具优化：文档库相关 MCP 工具的使用体验和稳定性均有提升。

---

其他功能与体验

非 MCP 环境使用方式

• 在不支持 MCP 的编辑器或环境（如 moltbot）下，可通过 mcporter 命令行 调用云开发 MCP 能力，文档中已补充配置说明。

文档与配置

• 文档中补充了连接方式、Skills 使用说明、以及各 IDE 的配置复制/同步说明。
• 各 IDE 的 CloudBase 规则与指南已同步更新，Trae 等 IDE 的 MCP 安装与 Agent 使用指引更完整。
• 小程序开发文档中增加了 Icons8 图标资源推荐；文档术语统一为「Skill」（原「提示词」）。

问题修复

• 云函数不存在或配置错误时，错误提示更准确。
• 云开发 API 调用因版本不一致导致失败的问题已修复。
• README 中托管模式的 MCP 地址已更正。

CloudBase MCP v2.8.0

CloudBase MCP v2.8.0

🤖 AI 能力

AI 模型调用

• 新增 AI 模型调用技能，支持在 Web、小程序和云函数中调用大语言模型
• 新增 AI 模型规则文件，为多个 IDE 提供 AI 开发指导
• 为云函数新增超时配置说明，确保 AI 操作（如图像生成）有足够的执行时间
• 优化 AI 模型文档组织，按平台拆分为 Web SDK、小程序 SDK 和 Node SDK
• 明确图像生成功能仅在 Node SDK 中可用

AI 开发体验

• 新增 AI 开发提示组件，提升 IDE 中的开发引导体验
• 新增控制台 AI 开发入口演示

📚 规则和文档

规则文件增强

• 新增云函数开发规则文件，涵盖运行时选择、部署、日志和 HTTP 访问配置
• 新增云存储 Web SDK 规则文件，包含上传、下载、临时链接和文件管理
• 新增身份认证工具规则文件，支持配置各种登录方式（短信、邮箱、微信、Google 等）
• 优化集成提示词，增强 AI 对云开发能力的理解

文档改进

• 新增 IDE 支持贡献指南，帮助社区添加新 IDE 支持
• 新增规则管理工作流文档，规范规则文件的维护流程
• 优化安全规则文档说明
• 为 README 添加品牌横幅图片
• 更新 FAQ，增加 CloudBase MCP 介绍

🛠️ 开发工具

模板和环境

• 下载模板工具现在需要明确指定 IDE 类型，提升配置准确性
• 优化 IDE 文件过滤机制，使用清单式管理确保文件完整性
• 优化环境列表字段，减少 token 消耗，提升性能
• 改进控制台 URL 配置，更新至最新路径

插件和扩展

• 新增插件启用/禁用参数，提供更灵活的配置选项
• 为 CLI 构建添加代码混淆，增强安全性
• 优化 CodeBuddy 界面体验

📖 教程内容

• 新增健康打卡 Web 应用教程文章
• 新增文章教程功能，支持内容过滤规则
• 增强 SEO 保护机制，优化教程内容展示
• 优化教程布局和组件格式

🐛 问题修复

• 修复身份认证登录 URL 参数，支持无环境模式
• 修复 Node SDK 版本识别问题
• 修复安全规则文档中的错误说明
• 修复文档中的 uid 字段错误
• 修复 IDE 文件映射问题
• 修复 URL 配置错误
• 修复函数配置更新问题

🔧 其他改进

• 优化文档和组件格式，提升可读性
• 更新多个规则文件，保持最新最佳实践
• 改进文件映射和导出机制

CloudBase AI Toolkit v2.6.1

CloudBase AI Toolkit v2.6.1

新功能

IDE 支持

• 新增微信开发者工具支持，可通过 CodeBuddy 扩展在微信开发者工具中使用 CloudBase AI 功能

环境管理

• 优化环境设置流程，改进交互式界面体验
• 新增账户切换功能，支持在不同账户间切换
• 新增账户信息显示功能
• 优化账户切换时的登录页面跳转

开发工具

• 新增 CAPI 工具注册和实现
• 新增日志回调功能，支持自定义日志处理
• 新增 setLogger 方法，提供更灵活的日志配置

文档和用户体验

• 新增错误代码 IDE 辅助组件，帮助用户快速定位和解决问题
• 新增 Kiro IDE 支持
• 集成教程组件，默认展开教程章节
• 更新工具文档和版本信息
• 添加 GitHub 和 CNB 项目链接

数据分析

• 新增核心组件的用户行为追踪功能

问题修复

• 修复缓存资源下载问题
• 修复竞态条件导致的读取错误
• 修复账户切换时的页面跳转问题

依赖更新

• 更新 jws 依赖从 3.2.2 到 3.2.3

其他改进

• 更新开发规则文档
• 优化代码格式
• 改进文档结构和内容组织

🚀 CloudBase AI Toolkit v2.3.0

🚀 CloudBase AI Toolkit v2.3.0

🎉 What's New

✨ Features

• New IDE Support:

  • Google Antigravity: Add full support for Google Antigravity IDE with workspace rules integration
  • Qoder: Add complete Qoder IDE support with MCP configuration and rules directory sync

• Enhanced Rules Directory Sync:

  • Support rules directory synchronization for multiple IDEs (Antigravity, Qoder, Cursor, Trae, WindSurf, Cline)
  • Automatic .md to .mdc conversion for Cursor and Antigravity
  • Maintain directory structure and file relationships via hard links

• Documentation UI Enhancements:

  • Add card-style layout for templates and tutorials pages
  • Enhance IDE icon grid with better visual presentation
  • Improve user experience with modern UI components

• VSCode Integration:

  • Add one-click install support for VSCode
  • Rename Visual Studio Code to VSCode for consistency

• CodeBuddy Improvements:

  • Add CodeBuddy Code support
  • Fix CodeBuddy skills linking issues
  • Improve CodeBuddy manual configuration

🐛 Bug Fixes

• Fix IDE detection from environment variables
• Fix CodeBuddy skills linking
• Remove default test configurations
• Improve IDE selector documentation

🔧 Improvements

• Update CloudBase Manager Node to latest version
• Enhance setup tool with directory-based file mappings
• Improve hardlink script for better rules synchronization
• Refactor IDE selector component for better maintainability

📚 Documentation

• Add comprehensive setup guides for Antigravity and Qoder IDEs
• Update IDE configuration documentation
• Enhance user guides with better examples

---

📋 Full Changelog

Full Changelog: v2.1.0...v2.3.0

---

🚀 Upgrade Guide

Update MCP Tool

Method 1: Auto Update (Recommended)
In your AI development tool's MCP list, find cloudbase and re-enable or refresh the MCP list to automatically install the latest version.

Method 2: Manual Update
If auto-update doesn't work, disable and re-enable cloudbase, or restart your AI IDE.

Method 3: Use Latest Version

{
  "mcpServers": {
    "cloudbase": {
      "command": "npx",
      "args": ["@cloudbase/cloudbase-mcp@latest"],
      "env": {
        "INTEGRATION_IDE": "YourIDE"
      }
    }
  }
}

Update Project Rules

In your project, tell AI:

在当前项目中下载云开发 AI 规则，并强制覆盖

Or specify a specific IDE:

在当前项目中下载云开发 AI 规则，只包含 Cursor 配置，并强制覆盖

---

🙏 Acknowledgments

Thanks to all contributors who made this release possible!

Special thanks to the community for feedback and suggestions that help us continuously improve the toolkit.

---

📞 Get Help

• 📖 Full Documentation
• 💬 Community Discussions
• 🐛 Report Issues

---

⭐ If this project helps you, please give us a Star!