@cloudbase/cloudbase-mcp 2.22.0 → 2.23.1

package/README.md

@@ -1,6 +1,6 @@
 <div align="center"><a name="readme-top"></a>
 
-  
+
 <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>
 
 ![](scripts/assets/toolkit-better.gif)
@@ -121,6 +121,29 @@ AI 编程工具（如 OpenClaw、Cursor、CodeBuddy）解决了**代码生成**
 }
 ```
 
+#### 方式三：自建服务器部署（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 参数控制插件启用范围：
@@ -140,15 +163,15 @@ https://tcb-api.cloud.tencent.com/mcp/v1?env_id=YOUR_ENV_ID&disable_plugins=rag,
 
 > [!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)
 
 ### 首次使用
@@ -174,6 +197,7 @@ https://tcb-api.cloud.tencent.com/mcp/v1?env_id=YOUR_ENV_ID&disable_plugins=rag,
 |------|----------|----------|
 | [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) |
@@ -447,6 +471,18 @@ CloudBase MCP 基于标准 MCP 协议，支持所有兼容 MCP 的工具——
 
 </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>
@@ -511,7 +547,7 @@ CloudBase MCP 工具本身完全开源免费（MIT）。云开发环境有免费
 </div>
 
 <!-- Image Placeholders - 这些图片需要实际生成或替换 -->
-<!-- 
+<!--
 设计风格约束（所有图片统一遵循）：
 - 现代扁平化设计，简洁而富有活力
 - 背景色：纯黑色 #000000（统一黑色背景）