npm - @cloudbase/cloudbase-mcp - Versions diffs - 2.24.1 → 2.25.0 - Mend

@cloudbase/cloudbase-mcp 2.24.1 → 2.25.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/README.md CHANGED Viewed

@@ -1,89 +1,37 @@
 <div align="center"><a name="readme-top"></a>
+<img src="https://raw.githubusercontent.com/TencentCloudBase/CloudBase-AI-Toolkit/main/mcp/icon.png" width="96" height="96" alt="CloudBase AI Toolkit" />
-<a href="https://cloud.tencent.com/developer/article/2649588" target="_blank"><img width="3094" height="654" alt="banner" src="https://github.com/user-attachments/assets/37982d04-274a-4b6c-85b8-06983c615d9a" /></a>
+# @cloudbase/cloudbase-mcp
-![](scripts/assets/toolkit-better.gif)
+**MCP Server for Tencent CloudBase.** Part of [CloudBase AI Toolkit](https://github.com/TencentCloudBase/CloudBase-AI-Toolkit).
-<h1>CloudBase MCP</h1>
-**🪐 AI 编程，一键上线**<br/>
-连接 AI IDE 与腾讯云 CloudBase 的部署桥梁，让你的 AI 应用即刻上线<br/>
-<sup>💡 像 Vercel + Supabase，但全程 AI 驱动——从提示词直达生产环境</sup>
-[English](./README-EN.md) · **简体中文** · [文档][docs] · [更新日志][changelog] · [反馈问题][github-issues-link]
-<!-- SHIELD GROUP -->
+Operate CloudBase from AI coding tools: login, databases, functions, storage, hosting, and logs—via the Model Context Protocol.
+**English** · [简体中文](./README.zh-CN.md) · [Toolkit README](../README.md) · [Docs][docs] · [Changelog][changelog] · [Issues][github-issues-link]
 [![][npm-version-shield]][npm-link]
 [![][npm-downloads-shield]][npm-link]
 [![][github-stars-shield]][github-stars-link]
-[![][github-forks-shield]][github-forks-link]
-[![][github-issues-shield]][github-issues-link]
 ![][github-license-shield]
-![][github-contributors-shield]
-[![][cnb-shield]][cnb-link]
-[![][deepwiki-shield]][deepwiki-link]
-⭐ 喜欢这个项目？点个 Star，新版本发布时你会收到通知～
-**发现了一个让 AI 编程一键上线的神器，推荐给正在用 AI 编程的朋友**
-[![][share-x-shield]][share-x-link]
-[![][share-telegram-shield]][share-telegram-link]
-[![][share-weibo-shield]][share-weibo-link]
-<sup>从 AI 提示词到应用上线的最短路径</sup>
-<img width="1148" height="389" alt="Clipboard_Screenshot_1764660604" src="https://github.com/user-attachments/assets/86294f88-632e-46b5-958f-94d8c8b85070" />
-[![][github-trending-shield]](https://github.com/TencentCloudBase/CloudBase-MCP)
-[<img width="791" height="592" alt="Clipboard_Screenshot_1763724670" src="https://github.com/user-attachments/assets/f769beb7-5710-4397-8854-af2b7e452f70" />](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/tutorials)
 </div>
-## 为什么你需要 CloudBase MCP？
-AI 编程工具（如 OpenClaw、Cursor、CodeBuddy）解决了**代码生成**的难题。
-但是，从"生成代码"到"应用上线"（部署、配置数据库、CDN、域名），依然存在一条鸿沟。
-**CloudBase MCP**（原 CloudBase AI ToolKit）填补了这条鸿沟。
-你不再需要：
-- ❌ 繁琐的 DevOps 配置和 YAML 文件
-- ❌ 手动设置云函数和数据库
-- ❌ 在 IDE 和云控制台之间反复横跳
-你只需要在 AI IDE 中，用自然语言完成从"想法"到"上线"的全过程。
-<details>
-<summary><kbd>目录</kbd></summary>
-- [🚀 快速开始](#-快速开始)
-- [✨ 核心特性](#-核心特性)
-- [📦 安装配置](#-安装配置)
-- [🎯 使用案例](#-使用案例)
-- [🧩 MCP 工具](#-mcp-工具)
-- [📚 更多资源](#-更多资源)
-</details>
-## 🚀 快速开始
+## What this package is
-### 一行配置，立即使用
+`@cloudbase/cloudbase-mcp` is the npm distribution of the CloudBase MCP Server. It is one piece of the Toolkit:
-在支持 MCP 的 AI IDE 中（Cursor、WindSurf、CodeBuddy 等）添加下方任一配置即可。连接方式有两种：
+| Piece | Role |
+|------|------|
+| **Plugin** | Installs MCP + Skills + Hooks together |
+| **Agent Skills** | Scenario skills toward workable CloudBase practice |
+| **MCP** (this package) | Tools the agent calls to act on your CloudBase environment |
----
+Prefer Plugin when your IDE supports it. Use this package alone when you only need MCP config.
-#### 方式一：本地模式（推荐）
+Full Toolkit narrative, related repos, and IDE matrix: [repository README](../README.md).
-**含义**：MCP 服务在你本机通过 `npx` 启动，与 IDE 同机运行。
-**优点**：功能最全（包含上传/下载、模板安装等依赖本地文件系统的能力）。
-**要求**：本机已安装 Node.js，且能执行 `npx`。
+## Quick start
 ```json
 {
@@ -96,15 +44,31 @@ AI 编程工具（如 OpenClaw、Cursor、CodeBuddy）解决了**代码生成**
 }
 ```
----
+First prompts:
-#### 方式二：托管模式
+```
+Login to CloudBase
+```
+```
+Use CloudBase Skills to build a todo app with login, database and permissions, then deploy
+```
+You need a [CloudBase environment](https://tcb.cloud.tencent.com/dev) and should confirm sensitive actions the AI proposes.
-**含义**：MCP 服务运行在腾讯云上，IDE 通过 HTTP 连接云端服务，无需在本地安装或运行 Node。
-**优点**：不依赖本机环境，配置好密钥即可使用。
-**限制**：部分依赖本地文件系统的能力不可用（如本地文件上传、模板下载到本机等）。
+### Other install paths
-将下面配置中的 `<env_id>`、`<腾讯云 Secret ID>`、`<腾讯云 Secret Key>` 替换为你的环境 ID 和腾讯云 API 密钥：
+| Path | When |
+|------|------|
+| `npx plugins add TencentCloudBase/cloudbase-plugin` | Open Plugin Spec tools |
+| `npm i -g @cloudbase/cli && tcb ai` | [CloudBase AI CLI](https://docs.cloudbase.net/cli-v1/ai/introduce) configures many IDEs |
+| Marketplace / built-in plugin | Claude Code, Codex, CodeBuddy, WorkBuddy, ZCode, etc. |
+## Connection modes
+**Local** (default): `npx` on your machine—full features, including local filesystem upload/templates. Requires Node.js v18.15.0+.
+**Hosted**: IDE connects over HTTP to Tencent Cloud MCP; no local Node. Some local-file features are unavailable.
 ```json
 {
@@ -113,217 +77,39 @@ AI 编程工具（如 OpenClaw、Cursor、CodeBuddy）解决了**代码生成**
       "type": "http",
       "url": "https://tcb-api.cloud.tencent.com/mcp/v1?env_id=<env_id>",
       "headers": {
-        "X-TencentCloud-SecretId": "<腾讯云 Secret ID>",
-        "X-TencentCloud-SecretKey": "<腾讯云 Secret Key>"
+        "X-TencentCloud-SecretId": "<Tencent Cloud Secret ID>",
+        "X-TencentCloud-SecretKey": "<Tencent Cloud Secret Key>"
       }
     }
   }
 }
 ```
-#### 方式三：自建服务器部署（Cloud Mode）
-**含义**：在自有服务器上运行 MCP 服务，通过环境变量 `CLOUDBASE_MCP_CLOUD_MODE=true` 启用云端模式。
-**适用场景**：需要在远程服务器上自行部署 MCP 服务端，对外提供 Streamable HTTP 接口。
-**安全机制**：启用 Cloud Mode 后，所有涉及本地文件系统读写和本地进程启动的工具将**自动禁用**，确保远程调用方无法操作服务器本地资源。
-```bash
-# 启用云端模式的环境变量（二选一）
-export CLOUDBASE_MCP_CLOUD_MODE=true
-# 或
-export MCP_CLOUD_MODE=true
-```
-Cloud Mode 下被禁用的工具包括：`downloadRemoteFile`、`downloadTemplate`、`manageCloudRun`（本地运行）、`manageApps`（本地代码上传部署）、`manageStorage`（本地文件上传/下载）、`createFunction`（本地代码上传）等涉及本地文件 I/O 的操作。
-> [!IMPORTANT]
-> **部署模式选择建议：**
-> - **个人开发**：使用本地模式（`npx`），功能最全
-> - **团队协作 / 远程服务**：使用腾讯云托管模式（方式二），免运维
-> - **自建服务器**：务必设置 `CLOUDBASE_MCP_CLOUD_MODE=true`，禁用本地文件操作类工具
----
-**托管模式可选：通过 URL 控制插件启用范围**
-在 `url` 里可通过 query 参数控制插件启用范围：
-- `enable_plugins`：仅启用指定插件，多个插件使用逗号分隔，例如只启用 `env` 和 `database`
-- `disable_plugins`：从默认插件集合中禁用指定插件，多个插件使用逗号分隔，例如禁用 `rag` 和 `env`
-```
-# 只启用指定插件
-https://tcb-api.cloud.tencent.com/mcp/v1?env_id=YOUR_ENV_ID&enable_plugins=env,database
-# 禁用指定插件
-https://tcb-api.cloud.tencent.com/mcp/v1?env_id=YOUR_ENV_ID&disable_plugins=rag,env
-```
-当前可配置的插件名以 `mcp/src/server.ts` 为准，建议优先使用 canonical 名称：`env`, `database`, `pg_database`, `pg_storage`, `mysql_database`, `functions`, `hosting`, `storage`, `setup`, `rag`, `download`, `gateway`, `cloudrun`, `app-auth`, `permissions`, `logs`, `agents`, `apps`, `invite-code`, `capi`, `database-nosql`, `database-sql`, `data-model`。
-> [!TIP]
-> **推荐使用 CloudBase AI CLI**
->
-> 一键安装，自动配置，支持多种 AI 编程工具：
->
-> ```bash
-> npm install @cloudbase/cli@latest -g
-> ```
->
-> 安装后运行 `tcb ai` 即可开始使用
->
-> [查看完整文档](https://docs.cloudbase.net/cli-v1/ai/introduce) | [详细案例教程](https://docs.cloudbase.net/practices/ai-cli-mini-program)
-### 首次使用
-1. **登录云开发**
-   ```
-   登录云开发
-   ```
-   AI 会自动打开登录界面并引导环境选择
-2. **开始开发**
-   ```
-   做一个双人在线对战五子棋网站，支持联机对战，最后进行部署
-   ```
-   AI 会自动生成代码、部署到云端并返回访问链接
-### 支持的 AI IDE
-| 工具 | 支持平台 | 查看指引 |
-|------|----------|----------|
-| [CloudBase AI CLI](https://docs.cloudbase.net/cli-v1/ai/introduce) | 命令行工具 | [查看指引](https://docs.cloudbase.net/cli-v1/ai/introduce) |
-| [OpenClaw](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/openclaw) | 命令行工具 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/openclaw) |
-| [WorkBuddy](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/workbuddy) | 独立 IDE | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/workbuddy) |
-| [Cursor](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/cursor) | 独立 IDE| [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/cursor) |
-| [WindSurf](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/windsurf) | 独立 IDE, VSCode、JetBrains 插件 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/windsurf) |
-| [CodeBuddy](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/codebuddy) | 独立 IDE（已内置 CloudBase），VS Code、JetBrains、微信开发者工具| [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/codebuddy) |
-| [CLINE](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/cline) | VS Code 插件 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/cline) |
-| [GitHub Copilot](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/github-copilot) | VS Code 插件 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/github-copilot) |
-| [Trae](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/trae) | 独立 IDE | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/trae) |
-| [通义灵码](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/tongyi-lingma) | 独立 IDE，VS Code、 JetBrains插件 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/tongyi-lingma) |
-| [RooCode](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/roocode) | VS Code插件 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/roocode) |
-| [文心快码](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/baidu-comate) | VS Code、JetBrains插件| [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/baidu-comate) |
-| [Augment Code](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/augment-code) | VS Code、JetBrains 插件 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/augment-code) |
-| [Claude Code](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/claude-code) | 命令行工具 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/claude-code) |
-| [Gemini CLI](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/gemini-cli) | 命令行工具 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/gemini-cli) |
-| [OpenAI Codex CLI](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/openai-codex-cli) | 命令行工具 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/openai-codex-cli) |
-| [OpenCode](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/opencode) | 命令行工具 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/opencode) |
-| [Qwen Code](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/qwen-code) | 命令行工具 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/qwen-code) |
-## ✨ 如何实现 AI 编程"一键上线"？
-### 1. AI 原生（AI-Native）
-我们不是简单的"胶水代码"。内置的规则库专为 AI 编程设计，能让 AI 直接生成"可部署"的 CloudBase 最佳实践代码。
-```markdown
-提示词：生成一个用户登录功能
-- AI 自动生成符合云开发规范的代码
-- 自动配置数据库、云函数、安全规则
-- 一键部署到云端
-```
-<img width="1200" alt="AI Native" src="scripts/assets/cloudbase-mcp-card-01.png" />
-### 2. 一键部署（One-Click Deploy）
-AI 自动化的 MCP 部署流，AI 帮你搞定从云函数、数据库到静态网站的**所有**云上资源配置。
-```markdown
-提示词：部署当前项目到云开发
-- 自动检测项目类型（Web/小程序/后端）
-- 智能配置部署参数
-- 实时显示部署进度
-- 自动返回访问链接
-```
-<img width="1200" alt="One-Click Deploy" src="scripts/assets/cloudbase-mcp-card-02.png" />
-### 3. 智能调试（Smart Debugging）
-部署出错？不用怕。AI 会自动读取日志，帮你分析并修复问题，真正实现**开发-部署-调试**的闭环。
-```markdown
-提示词：报错了，错误是 xxxx
-- AI 自动查看云函数日志
-- 分析错误原因
-- 生成修复代码
-- 自动重新部署
-```
-<img width="1200" alt="Smart Debugging" src="scripts/assets/cloudbase-mcp-card-03.png" />
-### 4. 全栈支持（Full-Stack Ready）
-无论是 Web 应用、小程序还是后端服务，AI 都能为你处理，你只需专注业务逻辑。
-| 应用类型 | 技术栈 | 部署方式 |
-|---------|--------|---------|
-| **Web 应用** | React/Vue/Next.js | 静态托管 + CDN |
-| **微信小程序** | 原生/UniApp | 小程序发布 |
-| **后端服务** | Node.js/Python | 云函数/云托管 |
-<img width="1200" alt="Full-Stack Ready" src="scripts/assets/cloudbase-mcp-card-04.png" />
-### 5. 知识检索（Knowledge Search）
-内置云开发、微信小程序等专业知识库的智能向量检索，让 AI 更懂云开发。
-```markdown
-提示词：如何使用云数据库实现实时数据同步？
-- 智能检索云开发知识库
-- 返回相关文档和最佳实践
-- 提供代码示例
-```
-<img width="1200" alt="Knowledge Search" src="scripts/assets/cloudbase-mcp-card-05.png" />
-### 6. 灵活工作流（Flexible Workflow）
-支持 /spec 和 /no_spec 命令，根据任务复杂度智能选择。
-```markdown
-/spec - 完整工作流（需求→设计→任务→实现）
-/no_spec - 快速迭代（直接实现）
-```
+Hosted URLs can use `enable_plugins` / `disable_plugins` (comma-separated). Canonical plugin names: see `src/server.ts` in this package (e.g. `env`, `database`, `functions`, `hosting`, `storage`, `pg_database`, `cloudrun`, `logs`).
-<img width="1200" alt="Flexible Workflow" src="scripts/assets/cloudbase-mcp-card-06.png" />
+**Self-hosted Cloud Mode**: set `CLOUDBASE_MCP_CLOUD_MODE=true` (or `MCP_CLOUD_MODE=true`) so local file and process tools are disabled for remote callers.
+| Scenario | Suggestion |
+|------|------|
+| Personal | Local `npx` |
+| Team / zero ops | Hosted HTTP |
+| Self-hosted MCP | Cloud Mode required |
-## 📦 安装配置
+## Capabilities
-### 前置条件
+Typical backend work in your environment (confirm critical steps):
-- ✅ Node.js v18.15.0 及以上版本
-- ✅ 已开通 [腾讯云开发环境](https://tcb.cloud.tencent.com/dev)
-- ✅ 安装支持 MCP 的 AI IDE（[查看支持的 IDE](#支持的-ai-ide)）
-### 配置方式
-#### 方式一：CloudBase AI CLI（推荐）
-```bash
-# 安装
-npm install @cloudbase/cli@latest -g
-# 使用
-tcb ai
-```
+- **Database**: PostgreSQL and document DB, data models, CRUD, permissions
+- **Compute**: cloud functions / Cloud Run—author, deploy, invoke, debug
+- **Auth & storage**: login methods, object storage, permission linkage
+- **Release & ops**: static hosting / Mini Program publish; logs and redeploy
-#### 方式二：手动配置 MCP
+Tool catalog: [MCP tools](../doc/mcp-tools.md) · [tools.json](../scripts/tools.json)
-根据你使用的 AI IDE，添加 MCP 配置：
+## IDE config snippets
 <details>
-<summary><b>Cursor</b></summary>
-在 `.cursor/mcp.json` 中添加：
+<summary>Cursor (.cursor/mcp.json)</summary>
 ```json
 {
@@ -339,9 +125,7 @@ tcb ai
 </details>
 <details>
-<summary><b>WindSurf</b></summary>
-在 `.windsurf/settings.json` 中添加：
+<summary>WindSurf (.windsurf/settings.json)</summary>
 ```json
 {
@@ -357,263 +141,35 @@ tcb ai
 </details>
 <details>
-<summary><b>CodeBuddy</b></summary>
-CodeBuddy 已内置 CloudBase MCP，无需配置即可使用。
-</details>
-<details>
-<summary><b>其他 IDE</b></summary>
-查看 [完整配置指南](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/) 了解其他 IDE 的配置方式。
-</details>
-## 🎯 使用案例
-### 案例 1：双人在线对战五子棋
-**开发过程：**
-1. 输入需求："做个双人在线对战五子棋网站，支持联机对战"
-2. AI 生成：Web 应用 + 云数据库 + 实时数据推送
-3. 自动部署并获得访问链接
-**体验地址：** [五子棋游戏](https://cloud1-5g39elugeec5ba0f-1300855855.tcloudbaseapp.com/gobang/#/)
-<details>
-<summary>查看开发截图</summary>
-| 开发过程 | 最终效果 |
-|---------|---------|
-| ![][image-case1-dev] | ![][image-case1-result] |
-</details>
-### 案例 2：AI 宠物养成小程序
-**开发过程：**
-1. 输入："开发一个宠物小精灵养成小程序，使用 AI 增强互动"
-2. AI 生成：小程序 + 云数据库 + AI 云函数
-3. 导入微信开发者工具即可发布
-<details>
-<summary>查看开发截图与小程序预览</summary>
-![][image-case2]
-</details>
-### 案例 3：智能问题诊断
-当应用出现问题时，AI 自动查看日志、分析错误并生成修复代码。
-<details>
-<summary>查看智能诊断过程</summary>
-![][image-case3]
-</details>
-## 🧩 MCP 工具
-覆盖环境管理、数据库、云函数、静态托管、小程序发布等核心功能。
-| 分类 | 工具 | 核心功能 |
-|------|------|----------|
-| **环境** | 4 个 | 登录认证、环境查询、域名管理 |
-| **数据库** | 11 个 | 集合管理、文档 CRUD、索引、数据模型 |
-| **云函数** | 9 个 | 创建、更新、调用、日志、触发器 |
-| **静态托管** | 5 个 | 文件上传、域名配置、网站部署 |
-| **小程序** | 7 个 | 上传、预览、构建、配置、调试 |
-| **工具支持** | 3 个 | 模板、知识库搜索、交互对话 |
-[查看完整工具文档](doc/mcp-tools.md) | [工具规格 JSON](scripts/tools.json)
-## 📚 更多资源
-### 文档
-- [快速开始](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/getting-started)
-- [IDE 配置指南](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/)
-- [项目模板](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/templates)
-- [开发指南](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/development)
-- [插件系统](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/plugins)
-- [常见问题](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/faq)
-### 最新文章
-- [一个人就是一支团队：OpenClaw+CloudBase实现全自动开发上线](https://mp.weixin.qq.com/s/vKcnro2GrbjI_QyQohpNRw)
-- [Agent Skills实战分享：AI编程最后一公里，别让代码死在localhost里](https://mp.weixin.qq.com/s/soIEU5DG01xfrKMaCetGAA)
-- [查看更多视频与教程](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/tutorials)
-## ❓ 常见问题
-<details>
-<summary><b>跟 Vercel / Railway / Netlify 有什么不同？</b></summary>
-这些平台解决的是"部署"，CloudBase MCP 解决的是"从 AI 生成代码到部署上线"的完整链路。你不需要离开 IDE，不需要写配置文件，AI 自动帮你搞定云函数、数据库、CDN、域名等所有云资源。一句话：它们是部署工具，我们是 AI 原生的全栈开发+部署平台。
-</details>
-<details>
-<summary><b>不用 Cursor / Copilot 这些 AI IDE 也能用吗？</b></summary>
-CloudBase MCP 基于标准 MCP 协议，支持所有兼容 MCP 的工具——包括 Claude Code、Gemini CLI、OpenCode 等命令行工具。只要你的工具能配置 MCP Server，就能用。[查看完整支持列表](#支持的-ai-ide)。
-</details>
-<details>
-<summary><b>我的代码会被上传到哪里？安全吗？</b></summary>
-代码只会部署到**你自己的**腾讯云开发环境，不经过任何第三方。本地模式下 MCP 服务运行在你本机，代码不会离开你的电脑直到你主动部署。所有云端通信均走 HTTPS 加密。
-</details>
-<details>
-<summary><b>在服务器上部署 MCP 服务是否安全？</b></summary>
-CloudBase MCP 提供了完善的部署模式安全隔离机制：
-- **本地模式**（`npx` 启动）：MCP 服务运行在开发者本机，通过 stdio 与 AI IDE 通信。调用方就是开发者本人，拥有该机器的完整控制权。`downloadRemoteFile`、`manageCloudRun(action="run")` 等工具本质上等同于开发者在终端执行 `curl` 或 `node app.js`，这是产品的正常功能。
-- **云端/服务器模式**（设置 `CLOUDBASE_MCP_CLOUD_MODE=true`）：启用三层安全过滤机制，**所有涉及本地文件读写、本地进程启动的工具均被禁用**，远程调用方无法通过 MCP 操作服务器本地文件系统或启动本地进程。
-如果你需要在远程服务器上自行部署 MCP 服务，**务必设置 `CLOUDBASE_MCP_CLOUD_MODE=true` 环境变量**。使用腾讯云托管模式（Streamable HTTP）时已自动启用该保护。
-</details>
-<details>
-<summary><b>支持哪些类型的项目？</b></summary>
-几乎所有主流场景：React/Vue/Next.js 等 Web 应用、微信小程序、Node.js/Python/Go/Java 后端服务。AI 会自动检测项目类型并选择合适的部署策略（静态托管、云函数、云托管容器）。
-</details>
-<details>
-<summary><b>免费吗？需要付费吗？</b></summary>
-CloudBase MCP 工具本身完全开源免费（MIT）。云开发环境有免费额度，个人开发和小项目通常够用。超出免费额度后按量计费，详见 [计费说明](https://cloud.tencent.com/document/product/876/39095)。
-</details>
-<details>
-<summary><b>登录提示"环境不存在"怎么办？</b></summary>
+<summary>CodeBuddy</summary>
-1. 确认已在 [云开发控制台](https://tcb.cloud.tencent.com/) 开通环境
-2. 检查环境是否处于正常运行状态（非欠费/隔离）
-3. 重新执行"登录云开发"让 AI 引导选择正确的环境
+CloudBase is built in; manual MCP config is usually unnecessary.
 </details>
-## 💬 社区
-### 微信交流群
-<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>
-### 其他交流方式
-| 平台 | 链接 | 说明 |
-|------|------|------|
-| **官方文档** | [查看文档](https://docs.cloudbase.net/) | 完整的云开发文档 |
-| **Issue 反馈** | [提交问题](https://github.com/TencentCloudBase/CloudBase-MCP/issues) | Bug 反馈和功能请求 |
+Others: [IDE setup](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/).
-## 项目活跃度
+## Docs
-![Repo Activity](https://repobeats.axiom.co/api/embed/6cd6ed00da4384e43b24805c197f584626946dda.svg "Repobeats analytics image")
+- [Toolkit README](../README.md)
+- [Getting started](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/getting-started)
+- [AI plugins](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ai-agent-plugins)
+- [FAQ](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/faq)
+- [Changelog][changelog]
-## Contributors
-感谢所有为 CloudBase MCP 做出贡献的开发者！
-[![Contributors](https://contrib.rocks/image?repo=TencentCloudBase/CloudBase-MCP)](https://github.com/TencentCloudBase/CloudBase-MCP/graphs/contributors)
----
-<div align="center">
-**如果这个项目对你有帮助，请给我们一个 Star！**
-[![][github-stars-shield]][github-stars-link]
-[MIT](LICENSE) © TencentCloudBase
-</div>
+## License
-<!-- Image Placeholders - 这些图片需要实际生成或替换 -->
-<!--
-设计风格约束（所有图片统一遵循）：
-- 现代扁平化设计，简洁而富有活力
-- 背景色：纯黑色 #000000（统一黑色背景）
-- 主题色渐变：#67E9E9 → #4896FF → #2BCCCC（保持）
-- 活力点缀色：适度使用 #FFD93D（黄）、#6BCF7F（绿）作为点缀
-- 简洁几何形状（圆形、矩形、线条），无文字
-- 使用几何图形和图标表达概念，抽象化 UI 骨架
-- 宣传视频风格，现代 UI 骨架
-- 流畅线条、适度光效、平衡的色彩搭配
-提示词模板（所有图片无文字，纯几何形状和图标）：
-- image-overview: "抽象化 UI 骨架图，现代风格，纯黑色背景 #000000，主题色 #67E9E9 #4896FF #2BCCCC 渐变，适度活力点缀色，使用几何形状（圆形、矩形、流畅线条）和图标表达 AI IDE、代码生成、云端部署的流程，无文字，宣传视频风格，现代 UI 骨架"
-- image-ai-native: "抽象化代码生成界面骨架，现代风格，纯黑色背景，主题色青色蓝色渐变，使用矩形代表代码块，圆形代表 AI 图标，流畅线条代表连接关系，无文字，宣传视频风格，简洁几何图形"
-- image-deploy: "抽象化部署界面骨架，现代风格，纯黑色背景，主题色渐变，使用圆形进度指示器，矩形进度条，流畅线条表达部署流程，无文字，宣传视频风格，现代 UI 骨架"
-- image-fullstack: "抽象化全栈架构骨架图，现代风格，纯黑色背景，主题色渐变，使用圆形节点代表不同服务（Web/小程序/后端/数据库），流畅线条连接表达集成关系，几何形状图标化表达，无文字，宣传视频风格"
-- image-agent: "抽象化 AI 智能体界面骨架，现代风格，纯黑色背景，主题色渐变，使用圆形代表 Agent，矩形代表配置卡片，流畅线条表达数据流，几何形状图标化，无文字，宣传视频风格，现代 UI 骨架"
-- image-debug: "抽象化问题诊断界面骨架，现代风格，纯黑色背景，主题色渐变，使用矩形代表日志卡片，圆形代表状态指示，流畅线条表达分析流程，几何形状图标化，无文字，宣传视频风格"
-- image-knowledge: "抽象化知识检索界面骨架，现代风格，纯黑色背景，主题色渐变，使用矩形卡片代表搜索结果，圆形代表搜索图标，流畅线条表达关联关系，几何形状图标化，无文字，宣传视频风格，现代 UI 骨架"
-- image-workflow: "抽象化工作流选择界面骨架，现代风格，纯黑色背景，主题色渐变，使用圆形按钮代表两种模式，矩形面板代表选项，流畅线条表达流程，几何形状图标化，无文字，宣传视频风格"
-- image-case1-dev: "抽象化游戏开发界面骨架，现代风格，纯黑色背景，主题色渐变，使用几何形状代表代码编辑器、游戏界面元素，无文字，宣传视频风格，现代 UI 骨架"
-- image-case1-result: "抽象化游戏界面骨架，现代风格，纯黑色背景，主题色渐变，使用圆形和矩形代表游戏元素，几何形状图标化表达，无文字，宣传视频风格"
-- image-case2: "抽象化小程序开发界面骨架，现代风格，纯黑色背景，主题色渐变，使用矩形代表小程序界面，圆形代表功能模块，几何形状图标化，无文字，宣传视频风格，现代 UI 骨架"
-- image-case3: "抽象化问题诊断界面骨架，现代风格，纯黑色背景，主题色渐变，使用矩形代表日志卡片，圆形代表状态，流畅线条表达诊断流程，几何形状图标化，无文字，宣传视频风格"
--->
-[image-overview]: https://7463-tcb-advanced-a656fc-1257967285.tcb.qcloud.la/mcp/video-banner.png
-[image-ai-native]: https://via.placeholder.com/800x400/3B82F6/FFFFFF?text=AI+Native+Development
-[image-deploy]: https://via.placeholder.com/800x400/10B981/FFFFFF?text=One-Click+Deploy
-[image-fullstack]: https://via.placeholder.com/800x400/8B5CF6/FFFFFF?text=Full-Stack+Application
-[image-agent]: https://via.placeholder.com/800x400/EC4899/FFFFFF?text=AI+Agent+Development
-[image-debug]: https://via.placeholder.com/800x400/F59E0B/FFFFFF?text=Smart+Debugging
-[image-knowledge]: https://via.placeholder.com/800x400/06B6D4/FFFFFF?text=Knowledge+Search
-[image-workflow]: https://via.placeholder.com/800x400/6366F1/FFFFFF?text=Flexible+Workflow
-[image-case1-dev]: https://7463-tcb-advanced-a656fc-1257967285.tcb.qcloud.la/turbo-deploy/turbo-deploy-001.png
-[image-case1-result]: https://7463-tcb-advanced-a656fc-1257967285.tcb.qcloud.la/turbo-deploy/turbo-deploy-004.png
-[image-case2]: https://7463-tcb-advanced-a656fc-1257967285.tcb.qcloud.la/turbo-deploy/turbo-deploy-005.png
-[image-case3]: https://7463-tcb-advanced-a656fc-1257967285.tcb.qcloud.la/turbo-deploy/turbo-deploy-009.png
+[MIT](../LICENSE) · [TencentCloudBase](https://github.com/TencentCloudBase)
 <!-- Links -->
 [docs]: https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/
-[changelog]: https://github.com/TencentCloudBase/CloudBase-MCP/releases
-[github-issues-link]: https://github.com/TencentCloudBase/CloudBase-MCP/issues
-[github-stars-link]: https://github.com/TencentCloudBase/CloudBase-MCP/stargazers
-[github-forks-link]: https://github.com/TencentCloudBase/CloudBase-MCP/network/members
-[github-trending-url]: https://github.com/trending
+[changelog]: https://github.com/TencentCloudBase/CloudBase-AI-Toolkit/releases
+[github-issues-link]: https://github.com/TencentCloudBase/CloudBase-AI-Toolkit/issues
+[github-stars-link]: https://github.com/TencentCloudBase/CloudBase-AI-Toolkit/stargazers
 [npm-link]: https://www.npmjs.com/package/@cloudbase/cloudbase-mcp
-[cnb-link]: https://cnb.cool/tencent/cloud/cloudbase/CloudBase-MCP
-[deepwiki-link]: https://deepwiki.com/TencentCloudBase/CloudBase-MCP
 <!-- Shields -->
 [npm-version-shield]: https://img.shields.io/npm/v/@cloudbase/cloudbase-mcp?color=3B82F6&label=npm&logo=npm&style=flat-square
 [npm-downloads-shield]: https://img.shields.io/npm/dw/@cloudbase/cloudbase-mcp?color=10B981&label=downloads&logo=npm&style=flat-square
-[github-stars-shield]: https://img.shields.io/github/stars/TencentCloudBase/CloudBase-MCP?color=F59E0B&label=stars&logo=github&style=flat-square
-[github-forks-shield]: https://img.shields.io/github/forks/TencentCloudBase/CloudBase-MCP?color=8B5CF6&label=forks&logo=github&style=flat-square
-[github-issues-shield]: https://img.shields.io/github/issues/TencentCloudBase/CloudBase-MCP?color=EC4899&label=issues&logo=github&style=flat-square
+[github-stars-shield]: https://img.shields.io/github/stars/TencentCloudBase/CloudBase-AI-Toolkit?color=F59E0B&label=stars&logo=github&style=flat-square
 [github-license-shield]: https://img.shields.io/badge/license-MIT-6366F1?logo=github&style=flat-square
-[github-contributors-shield]: https://img.shields.io/github/contributors/TencentCloudBase/CloudBase-MCP?color=06B6D4&label=contributors&logo=github&style=flat-square
-[github-contributors-link]: https://github.com/TencentCloudBase/CloudBase-MCP/graphs/contributors
-[cnb-shield]: https://img.shields.io/badge/CNB-CloudBase--AI--ToolKit-3B82F6?logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTIiIGhlaWdodD0iMTIiIHZpZXdCb3g9IjAgMCAxMiAxMiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj48cmVjdCB3aWR0aD0iMTIiIGhlaWdodD0iMTIiIHJ4PSIyIiBmaWxsPSIjM0I4MkY2Ii8+PHBhdGggZD0iTTUgM0g3VjVINSIgc3Ryb2tlPSJ3aGl0ZSIgc3Ryb2tlLXdpZHRoPSIxLjUiLz48cGF0aCBkPSJNNSA3SDdWOUg1IiBzdHJva2U9IndoaXRlIiBzdHJva2Utd2lkdGg9IjEuNSIvPjwvc3ZnPg==&style=flat-square
-[deepwiki-shield]: https://deepwiki.com/badge.svg
-[github-trending-shield]: https://img.shields.io/github/stars/TencentCloudBase/CloudBase-MCP?style=social
-<!-- Share Links -->
-[share-x-link]: https://x.com/intent/tweet?hashtags=cloudbase,ai,devtools&text=AI%20编程%2C%20一键上线！告别繁琐的%20DevOps%20配置%2C%20从提示词到应用上线的最短路径%20🚀&url=https://github.com/TencentCloudBase/CloudBase-MCP
-[share-x-shield]: https://img.shields.io/badge/-share%20on%20x-black?labelColor=black&logo=x&logoColor=white&style=flat-square
-[share-telegram-shield]: https://img.shields.io/badge/-share%20on%20telegram-black?labelColor=black&logo=telegram&logoColor=white&style=flat-square
-[share-telegram-link]: https://t.me/share/url?url=https://github.com/TencentCloudBase/CloudBase-MCP&text=AI%20编程%2C%20一键上线！告别繁琐的%20DevOps%20配置%2C%20从提示词到应用上线的最短路径%20🚀
-[share-weibo-link]: http://service.weibo.com/share/share.php?sharesource=weibo&title=AI%20编程%2C%20一键上线！告别繁琐的%20DevOps%20配置%2C%20从提示词到应用上线的最短路径%20🚀&url=https://github.com/TencentCloudBase/CloudBase-MCP
-[share-weibo-shield]: https://img.shields.io/badge/-share%20on%20weibo-black?labelColor=black&logo=sinaweibo&logoColor=white&style=flat-square