空白 MCP Server

前往云开发平台通过空白模板创建 MCP Server

介绍

当前模板是一个基本的 MCP Server 模板，包含了一个完整的 MCP Server 项目。可以以此项目为基础进行修改，开发您自己的 MCP Server。

会介绍如何使用此项目代码进行本地开发调试以及部署。

下载代码包

点击此处下载项目代码

本地开发调试

安装依赖

npm i

登录命令行

@cloudbase/cli 需要登录后才能使用，使用云开发账号登录:

npm run login

环境变量

将 .env.template 更名为 .env.development ，该文件定义了环境变量：

• SKIP_VERIFY_ACCESS=true：设置后可跳过 token 校验。原有 token 校验将只允许来自 API Key 和超管身份的 token 调用
• CLOUDBASE_ENVIRONMENT=your-env-id：在云托管线上环境中，上下文里包含了云开发环境 id。在本地开发时，我们通过设置该环境变量来提供环境 id。请设置一个当前登录账号下的环境 id

设置 SKIP_VERIFY_ACCESS 这两个环境变量有助于我们在本地进行调试，但不建议在线上生产环境设置。

启动本地 MCP Server 服务

npm run dev

启动后，将会在 http://localhost:3000/messages 提供服务。

修改代码，即可触发重新编译并重启服务。

启动图形界面调试

运行 MCP Inspector:

npx @modelcontextprotocol/inspector

前往 http://localhost:6274/ 进行调试。

1. 在左侧选择 Streamable HTTP 类型，并填入 URL 为 http://localhost:3000/messages
2. 在左侧点击 Connect
3. 在 Tools tab 下点击 List Tools 展示工具列表
4. 选择任一工具进行调用

部署至云托管

构建

npm run build

部署

该 MCP Server 能够直接部署至云托管，但要在云开发 Agent 中使用，需要在控制台先创建一个 MCP Server，再覆盖其云托管服务。

首先，前往云开发平台创建一个 MCP Server。

创建完成后，运行 cli 部署命令，填入对应的 MCP 标识。

npm run deploy

🔌 使用方式

• 在云开发 Agent 中使用
• 在 MCP Host 中使用
• 通过 SDK 接入

---

云开发 MCP 控制台