CloudBase-MCP

Name: CloudBase-MCP
Author: TencentCloudBase

1.1kstars132forks

How to install CloudBase-MCP?

tencentcloudbase/cloudbase-mcp

$git clone https://github.com/TencentCloudBase/CloudBase-MCP

Installs into the current project.

Summary

🪐 AI 编程，一键上线<br/> 连接 AI IDE 与腾讯云 CloudBase 的部署桥梁，让你的 AI 应用即刻上线<br/> <sup>💡 像 Vercel + Supabase，但全程 AI 驱动——从提示词直达生产环境</sup>

Files · 1

View on GitHub

README.md

1	<div align="center"><a name="readme-top"></a>
2
3
4	<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>
5
6	![](scripts/assets/toolkit-better.gif)
7
8	<h1>CloudBase MCP</h1>
9
10	🪐 AI 编程，一键上线<br/>
11	连接 AI IDE 与腾讯云 CloudBase 的部署桥梁，让你的 AI 应用即刻上线<br/>
12	<sup>💡 像 Vercel + Supabase，但全程 AI 驱动——从提示词直达生产环境</sup>
13
14	[English](./README-EN.md) · 简体中文 · [文档][docs] · [更新日志][changelog] · [反馈问题][github-issues-link]
15
16	<!-- SHIELD GROUP -->
17
18
19	[![][npm-version-shield]][npm-link]
20	[![][npm-downloads-shield]][npm-link]
21	[![][github-stars-shield]][github-stars-link]
22	[![][github-forks-shield]][github-forks-link]
23	[![][github-issues-shield]][github-issues-link]
24	![][github-license-shield]
25	![][github-contributors-shield]
26	[![][cnb-shield]][cnb-link]
27	[![][deepwiki-shield]][deepwiki-link]
28
29	⭐ 喜欢这个项目？点个 Star，新版本发布时你会收到通知～
30
31	发现了一个让 AI 编程一键上线的神器，推荐给正在用 AI 编程的朋友
32
33	[![][share-x-shield]][share-x-link]
34	[![][share-telegram-shield]][share-telegram-link]
35	[![][share-weibo-shield]][share-weibo-link]
36
37	<sup>从 AI 提示词到应用上线的最短路径</sup>
38
39	<img width="1148" height="389" alt="Clipboard_Screenshot_1764660604" src="https://github.com/user-attachments/assets/86294f88-632e-46b5-958f-94d8c8b85070" />
40
41	[![][github-trending-shield]](https://github.com/TencentCloudBase/CloudBase-MCP)
42
43	[<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)
44
45	</div>
46
47	## 为什么你需要 CloudBase MCP？
48
49	AI 编程工具（如 OpenClaw、Cursor、CodeBuddy）解决了代码生成的难题。
50
51	但是，从"生成代码"到"应用上线"（部署、配置数据库、CDN、域名），依然存在一条鸿沟。
52
53	CloudBase MCP（原 CloudBase AI ToolKit）填补了这条鸿沟。
54
55	你不再需要：
56	- ❌ 繁琐的 DevOps 配置和 YAML 文件
57	- ❌ 手动设置云函数和数据库
58	- ❌ 在 IDE 和云控制台之间反复横跳
59
60	你只需要在 AI IDE 中，用自然语言完成从"想法"到"上线"的全过程。
61
62	<details>
63	<summary><kbd>目录</kbd></summary>
64
65	- [🚀 快速开始](#-快速开始)
66	- [✨ 核心特性](#-核心特性)
67	- [📦 安装配置](#-安装配置)
68	- [🎯 使用案例](#-使用案例)
69	- [🧩 MCP 工具](#-mcp-工具)
70	- [📚 更多资源](#-更多资源)
71
72	</details>
73
74	## 🚀 快速开始
75
76	### 一行配置，立即使用
77
78	在支持 MCP 的 AI IDE 中（Cursor、WindSurf、CodeBuddy 等）添加下方任一配置即可。连接方式有两种：
79
80	---
81
82	#### 方式一：本地模式（推荐）
83
84	含义：MCP 服务在你本机通过 `npx` 启动，与 IDE 同机运行。
85	优点：功能最全（包含上传/下载、模板安装等依赖本地文件系统的能力）。
86	要求：本机已安装 Node.js，且能执行 `npx`。
87
88	```json
89	{
90	"mcpServers": {
91	"cloudbase": {
92	"command": "npx",
93	"args": ["@cloudbase/cloudbase-mcp@latest"]
94	}
95	}
96	}
97	```
98
99	---
100
101	#### 方式二：托管模式
102
103	含义：MCP 服务运行在腾讯云上，IDE 通过 HTTP 连接云端服务，无需在本地安装或运行 Node。
104	优点：不依赖本机环境，配置好密钥即可使用。
105	限制：部分依赖本地文件系统的能力不可用（如本地文件上传、模板下载到本机等）。
106
107	将下面配置中的 `<env_id>`、`<腾讯云 Secret ID>`、`<腾讯云 Secret Key>` 替换为你的环境 ID 和腾讯云 API 密钥：
108
109	```json
110	{
111	"mcpServers": {
112	"cloudbase": {
113	"type": "http",
114	"url": "https://tcb-api.cloud.tencent.com/mcp/v1?env_id=<env_id>",
115	"headers": {
116	"X-TencentCloud-SecretId": "<腾讯云 Secret ID>",
117	"X-TencentCloud-SecretKey": "<腾讯云 Secret Key>"
118	}
119	}
120	}
121	}
122	```
123
124	#### 方式三：自建服务器部署（Cloud Mode）
125
126	含义：在自有服务器上运行 MCP 服务，通过环境变量 `CLOUDBASE_MCP_CLOUD_MODE=true` 启用云端模式。
127	适用场景：需要在远程服务器上自行部署 MCP 服务端，对外提供 Streamable HTTP 接口。
128	安全机制：启用 Cloud Mode 后，所有涉及本地文件系统读写和本地进程启动的工具将自动禁用，确保远程调用方无法操作服务器本地资源。
129
130	```bash
131	# 启用云端模式的环境变量（二选一）
132	export CLOUDBASE_MCP_CLOUD_MODE=true
133	# 或
134	export MCP_CLOUD_MODE=true
135	```
136
137	Cloud Mode 下被禁用的工具包括：`downloadRemoteFile`、`downloadTemplate`、`manageCloudRun`（本地运行）、`manageApps`（本地代码上传部署）、`manageStorage`（本地文件上传/下载）、`createFunction`（本地代码上传）等涉及本地文件 I/O 的操作。
138
139	> [!IMPORTANT]
140	> 部署模式选择建议：
141	> - 个人开发：使用本地模式（`npx`），功能最全
142	> - 团队协作 / 远程服务：使用腾讯云托管模式（方式二），免运维
143	> - 自建服务器：务必设置 `CLOUDBASE_MCP_CLOUD_MODE=true`，禁用本地文件操作类工具
144
145	---
146
147	托管模式可选：通过 URL 控制插件启用范围
148
149	在 `url` 里可通过 query 参数控制插件启用范围：
150
151	- `enable_plugins`：仅启用指定插件，多个插件使用逗号分隔，例如只启用 `env` 和 `database`
152	- `disable_plugins`：从默认插件集合中禁用指定插件，多个插件使用逗号分隔，例如禁用 `rag` 和 `env`
153
154	```
155	# 只启用指定插件
156	https://tcb-api.cloud.tencent.com/mcp/v1?env_id=YOUR_ENV_ID&enable_plugins=env,database
157
158	# 禁用指定插件
159	https://tcb-api.cloud.ten

People who liked this also viewed

6 picks

Type

CloudBase-MCP

1.1kstars132forks

View on GitHub

How to install CloudBase-MCP?

tencentcloudbase/cloudbase-mcp

$git clone https://github.com/TencentCloudBase/CloudBase-MCP

Installs into the current project.

Summary

Files · 1

View on GitHub

README.md

1	<div align="center"><a name="readme-top"></a>
2
3
4	<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>
5
6	![](scripts/assets/toolkit-better.gif)
7
8	<h1>CloudBase MCP</h1>
9
10	🪐 AI 编程，一键上线<br/>
11	连接 AI IDE 与腾讯云 CloudBase 的部署桥梁，让你的 AI 应用即刻上线<br/>
12	<sup>💡 像 Vercel + Supabase，但全程 AI 驱动——从提示词直达生产环境</sup>
13
14	[English](./README-EN.md) · 简体中文 · [文档][docs] · [更新日志][changelog] · [反馈问题][github-issues-link]
15
16	<!-- SHIELD GROUP -->
17
18
19	[![][npm-version-shield]][npm-link]
20	[![][npm-downloads-shield]][npm-link]
21	[![][github-stars-shield]][github-stars-link]
22	[![][github-forks-shield]][github-forks-link]
23	[![][github-issues-shield]][github-issues-link]
24	![][github-license-shield]
25	![][github-contributors-shield]
26	[![][cnb-shield]][cnb-link]
27	[![][deepwiki-shield]][deepwiki-link]
28
29	⭐ 喜欢这个项目？点个 Star，新版本发布时你会收到通知～
30
31	发现了一个让 AI 编程一键上线的神器，推荐给正在用 AI 编程的朋友
32
33	[![][share-x-shield]][share-x-link]
34	[![][share-telegram-shield]][share-telegram-link]
35	[![][share-weibo-shield]][share-weibo-link]
36
37	<sup>从 AI 提示词到应用上线的最短路径</sup>
38
39	<img width="1148" height="389" alt="Clipboard_Screenshot_1764660604" src="https://github.com/user-attachments/assets/86294f88-632e-46b5-958f-94d8c8b85070" />
40
41	[![][github-trending-shield]](https://github.com/TencentCloudBase/CloudBase-MCP)
42
43	[<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)
44
45	</div>
46
47	## 为什么你需要 CloudBase MCP？
48
49	AI 编程工具（如 OpenClaw、Cursor、CodeBuddy）解决了代码生成的难题。
50
51	但是，从"生成代码"到"应用上线"（部署、配置数据库、CDN、域名），依然存在一条鸿沟。
52
53	CloudBase MCP（原 CloudBase AI ToolKit）填补了这条鸿沟。
54
55	你不再需要：
56	- ❌ 繁琐的 DevOps 配置和 YAML 文件
57	- ❌ 手动设置云函数和数据库
58	- ❌ 在 IDE 和云控制台之间反复横跳
59
60	你只需要在 AI IDE 中，用自然语言完成从"想法"到"上线"的全过程。
61
62	<details>
63	<summary><kbd>目录</kbd></summary>
64
65	- [🚀 快速开始](#-快速开始)
66	- [✨ 核心特性](#-核心特性)
67	- [📦 安装配置](#-安装配置)
68	- [🎯 使用案例](#-使用案例)
69	- [🧩 MCP 工具](#-mcp-工具)
70	- [📚 更多资源](#-更多资源)
71
72	</details>
73
74	## 🚀 快速开始
75
76	### 一行配置，立即使用
77
78	在支持 MCP 的 AI IDE 中（Cursor、WindSurf、CodeBuddy 等）添加下方任一配置即可。连接方式有两种：
79
80	---
81
82	#### 方式一：本地模式（推荐）
83
84	含义：MCP 服务在你本机通过 `npx` 启动，与 IDE 同机运行。
85	优点：功能最全（包含上传/下载、模板安装等依赖本地文件系统的能力）。
86	要求：本机已安装 Node.js，且能执行 `npx`。
87
88	```json
89	{
90	"mcpServers": {
91	"cloudbase": {
92	"command": "npx",
93	"args": ["@cloudbase/cloudbase-mcp@latest"]
94	}
95	}
96	}
97	```
98
99	---
100
101	#### 方式二：托管模式
102
103	含义：MCP 服务运行在腾讯云上，IDE 通过 HTTP 连接云端服务，无需在本地安装或运行 Node。
104	优点：不依赖本机环境，配置好密钥即可使用。
105	限制：部分依赖本地文件系统的能力不可用（如本地文件上传、模板下载到本机等）。
106
107	将下面配置中的 `<env_id>`、`<腾讯云 Secret ID>`、`<腾讯云 Secret Key>` 替换为你的环境 ID 和腾讯云 API 密钥：
108
109	```json
110	{
111	"mcpServers": {
112	"cloudbase": {
113	"type": "http",
114	"url": "https://tcb-api.cloud.tencent.com/mcp/v1?env_id=<env_id>",
115	"headers": {
116	"X-TencentCloud-SecretId": "<腾讯云 Secret ID>",
117	"X-TencentCloud-SecretKey": "<腾讯云 Secret Key>"
118	}
119	}
120	}
121	}
122	```
123
124	#### 方式三：自建服务器部署（Cloud Mode）
125
126	含义：在自有服务器上运行 MCP 服务，通过环境变量 `CLOUDBASE_MCP_CLOUD_MODE=true` 启用云端模式。
127	适用场景：需要在远程服务器上自行部署 MCP 服务端，对外提供 Streamable HTTP 接口。
128	安全机制：启用 Cloud Mode 后，所有涉及本地文件系统读写和本地进程启动的工具将自动禁用，确保远程调用方无法操作服务器本地资源。
129
130	```bash
131	# 启用云端模式的环境变量（二选一）
132	export CLOUDBASE_MCP_CLOUD_MODE=true
133	# 或
134	export MCP_CLOUD_MODE=true
135	```
136
137	Cloud Mode 下被禁用的工具包括：`downloadRemoteFile`、`downloadTemplate`、`manageCloudRun`（本地运行）、`manageApps`（本地代码上传部署）、`manageStorage`（本地文件上传/下载）、`createFunction`（本地代码上传）等涉及本地文件 I/O 的操作。
138
139	> [!IMPORTANT]
140	> 部署模式选择建议：
141	> - 个人开发：使用本地模式（`npx`），功能最全
142	> - 团队协作 / 远程服务：使用腾讯云托管模式（方式二），免运维
143	> - 自建服务器：务必设置 `CLOUDBASE_MCP_CLOUD_MODE=true`，禁用本地文件操作类工具
144
145	---
146
147	托管模式可选：通过 URL 控制插件启用范围
148
149	在 `url` 里可通过 query 参数控制插件启用范围：
150
151	- `enable_plugins`：仅启用指定插件，多个插件使用逗号分隔，例如只启用 `env` 和 `database`
152	- `disable_plugins`：从默认插件集合中禁用指定插件，多个插件使用逗号分隔，例如禁用 `rag` 和 `env`
153
154	```
155	# 只启用指定插件
156	https://tcb-api.cloud.tencent.com/mcp/v1?env_id=YOUR_ENV_ID&enable_plugins=env,database
157
158	# 禁用指定插件
159	https://tcb-api.cloud.ten

People who liked this also viewed

6 picks

Type