跳到主要内容

空白 MCP Server

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

介绍​

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

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

下载代码包​

点击此处下载项目代码

本地开发调试​

安装依赖​

npm i

登录命令行​

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

npm run login

环境变量​

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

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

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

启动本地 MCP Server 服务​

npm run dev

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

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

启动图形界面调试​

运行 MCP Inspector:

npx @cloudbase/mcp-inspector

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

  1. 在左侧选择 POST 或 SSE 类型，并填入 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

部署后，即可阅读以下文档使用 MCP Server 了: