返回 MCP 首页

空白模板

@ 云开发

基于模板快速构建自己的业务逻辑
企业级场景
空白模板

空白 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 类型,并填入 URLhttp://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

🔌 使用方式


云开发 MCP 控制台