2026年7月2日 周四晚上19:30,报名腾讯会议了解“如何构建自进化的动态知识库(Brain)”(限30人)
免费POC, 零成本试错
FDE知识库

FDE知识库

学习大模型的前沿技术与行业落地应用


收藏

从零开始开发 MCP Server

发布日期:2025-04-17 18:18:02 浏览次数: 2391
作者:阿里云云原生

微信搜一搜,关注“阿里云云原生”

推荐语

利用Serverless Devs CLI工具,快速开发并部署MCP Server,实现AI能力与真实世界的无缝连接。

核心内容:
1. 介绍Model Context Protocol(MCP)及其在智能体开发中的重要性
2. 通过Serverless Devs CLI工具快速开发并一键部署MCP Server到阿里云函数计算(FC)
3. Serverless Devs平台的核心功能及与函数计算FC的紧密合作

杨芳贤
53AI创始人/腾讯云(TVP)最具价值专家


在大型语言模型(LLM)生态快速演进的今天,Model Context Protocol(MCP)作为连接 AI 能力与真实世界的标准化协议,正逐步成为智能体开发的事实标准。该协议通过定义 Resources(静态资源)、Prompts(提示词模板)和 Tools(可执行工具)三大核心能力,让开发者能够以模块化方式为 LLM 扩展文件系统访问、API 集成甚至物联网控制等交互能力。


然而当前 MCP Server 的开发部署仍存在显著痛点:开发者需要手动配置 Python/TypeScript SDK、处理依赖冲突,最终还需自行解决云端的 IaC 部署难题。这种碎片化体验使得从零构建 MCP Server 的成本过高。而通过 Serverless Devs CLI 工具,开发者能够一键拉起 MCP Server 项目,并在开发完成后一键部署到云端,显著缩短开发链路,提升 MCP Server 的开发效率。


本文将带你通过 Serverless Devs CLI 工具,开发并一键部署一个原生 SSE 的示例 MCP Server 到阿里云函数计算(FC),提供自带 LLM 的 Client ,可对部署好的 MCP Server 进行测试。


什么是 Serverless Devs?

Cloud Native


Serverless Devs【1】 是一个开源开放的 Serverless 开发者平台,致力于为开发者提供强大的工具链体系。通过该平台,开发者可以一键体验多云 Serverless 产品,极速部署 Serverless 项目。Serverless Devs 于 2020 年 10 月 23 日正式开源,并于 2022年 进入 CNCF 沙箱,成为首个入选的 Serverless 工具项目,目前项目已经服务于成千上万的开发者和企业用户。


Serverless Devs 包含 CLI 工具,Registry 各类热门 AI 应用模版、实用 AI 工具以及 AI 工作流),CICD 工具,并与函数计算 FC、FunctionAI 开发平台密切合作,为开发者提供更加便利的 Serverless+AI 服务。


从零开发 MCP Server

Cloud Native


本地初始化 MCP Server


初始化 MCP Server 项目到本地需要借助 Serverless Devs 工具。可依照此文档【2】进行安装。安装并配置完成后,通过以下指令初始化一个 Hello World MCP Server 项目:


s init start-mcp-nodejs-hello-world


按照提示填入地域,函数名和配置好的 access,即可完成项目的初始化:



项目的目录结构如下:


.├── build.yaml                  # 构建配置├── code                        # 项目代码目录│   ├── check_node_version.mjs  # 部署前检查脚本│   ├── package-lock.json       │   ├── package.json       │   ├── src│   │   └── index.ts            # 项目源码│   ├── tsconfig.json│   └── webpack.config.js├── readme.md└── s.yaml                      # 部署 YAML

开发 MCP Server


项目根目录下的 code 文件夹即是项目代码的目录,部署时只有这个文件夹里的内容会部署到函数计算 FC 上。打开 src/index.ts 文件,可以看到 CLI 已经帮你写好了一个简单的、可直接进行部署的Hello World MCP Server:


import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";import { z } from "zod";import express from "express";import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
// Create a map to store the transport for each sessionconst sessionTransportMap<stringSSEServerTransport> = new Map();
// Create a new server instance every time a new connection is made to ensure concurrencyconst createServer = () => {  // Create server instance  const server = new McpServer({    name"my-mcp-server",    version"1.0.0",  });
  // Implement your tools here  server.tool(    "hello_world",    "Return string 'hello world!'",    {      // Define input parameters using zod. example:       // prefix: z.string().describe('prefix').optional(),    },    async () => {      console.log("Hello World tool called");      return {        content: [{          type"text",          text'hello world!',        }]      }    },  );  return server;}
const app = express();
app.get("/sse"async (req, res) => {  console.log("SSE connection opened");  console.log("Request Headers:", req?.headers); // 按需输出特定属性  console.log("Request Query:", req?.query);  const server = createServer();  server.server.onclose = async () => {    await server.close();    sessionTransport.delete(transport.sessionId);  };  const transport = new SSEServerTransport("/messages", res);  sessionTransport.set(transport.sessionId, transport);  await server.server.connect(transport);  return;});
app.post("/messages"async (req, res) => {  const sessionId = req.query.sessionId as string;  if (!sessionId) {      throw new Error("sessionId query parameter is required");  }  const transport = sessionTransport.get(sessionId);  if (transport) {    console.log("SSE message received");    console.log("Request Headers:", req?.headers); // 按需输出特定属性    console.log("Request Query:", req?.query);    console.log("Request Body:", req?.body);    await transport.handlePostMessage(req, res);  }  return;});
app.listen(8080() => {  console.log('MCP Server running on port 8080');});


这个 Server 包含一个名字为 hello_world 的工具,它只会返回一个字符串 'hello world!',且不需要任何输入参数。你可以参考当前代码的实现自行修改工具,且 CLI 已经帮你配置好了 package.json,你可以按照你开发任意 Node.js 项目的方式来开发这个 Server。


部署 MCP Server 到函数计算 FC

Cloud Native


完成 Server 的开发后,你可以通过 Serverless Devs CLI 工具一键将你的 MCP Server 部署到函数计算。Serverless Devs 是通过 s.yaml 部署代码的,其需要包含所有部署需要的信息,包括实例规格、代码目录、触发器配置等等,而 CLI 已经帮你写好了,因此你不需要在意这些。


在部署之前,还需要对代码进行打包。在这里我们使用 webpack 进行打包,配置已经帮你写好了,因此你只需在 code 目录下执行以下指令:


注意:需要本地 node 版本为 20 或以上。


npm install # 如果你之前没有执行npm run build


若 code 目录下出现了 dist 文件夹并包含以下文件,则说明构建成功:



此时,你已经准备好将这个 Server 部署到函数计算了!回到项目根目录,执行以下指令:


s deploy -y


若看到以下信息,则说明部署成功。部署成功后,Serverless Devs 会打印部署成功的函数的配置信息:


✔ [start-mcp-nodejs-hello-world] completed (5.9s)
?  Result for [deploy] of [start-mcp-server-nodejs]====================region:               xxxxx......配置信息


其中,functionName 就是部署好的函数的名称,你可以登录阿里云函数计算控制台【3】查看。你还可以在配置信息中找到 system_url 字段,这个就是你的 MCP Server 的 URL,可以用于测试和集成到你自己的系统。


测试 MCP Server

Cloud Native


你可以本地启动一个官方 inspector【4】 测试部署好的 MCP,只需执行:


npx @modelcontextprotocol/inspector node build/index.js


或者,你也可以启动一个我们基于官方项目修改的,内置好了 LLM 的 inspector:


npx @serverless-devs/inspector node build/index.js


Transport Type 选择 SSE,复制之前部署获取到的 system_url,在尾部添加 /sse,然后粘贴到 URL 输入框。点击 Connect,再切到 Tools,点击 List Tools,即可看到部署好的 Server 的工具信息,并能进行调试。



若你使用的是我们的包含大模型的 inspector,还可以切到 LLM,选择大模型,填入你的 API Key,测试大模型使用你的工具的效果:


需要先点击 List Tools,否则大模型无法使用工具



三种方式接入客户端

Cloud Native


方式一:官方 Client


所有部署到函数计算 FC 的 MCP Server 都遵循 SSE 协议。对于已经支持 SSE 的官方 Client (例如Cursor),接入配置如下:


{  "mcpServers": {    "server-name": {      "url": "<部署好的system_url>/sse",      "env": { // 如果有的话        "key": "value"      }    }  }}


对于暂未支持 SSE 的 Client,可以参考一些开源社区代理解决方案,例如:


  • mcp-proxy【5】

  • supergateway【6】


方式二:其他本地 Client


对于非官方的 Client,接入 MCP Server 需要使用官方的提供的 sdk 进行连接。具体开发方式可参考官方文档【7】。一个示例 Node Client 如下:


import { Client } from "@modelcontextprotocol/sdk/client/index.js";import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
const client = new Client({  name"example-client",  version"1.0.0"}, {  capabilities: {}});
const transport = new SSEClientTransport(  new URL("<部署好的system_url>/sse"));await client.connect(transport);

方式三:在 FC 部署一个 Client


如果你需要一个远端的 Client,你也可以在函数计算 FC 应用中心部署 inspector 到函数计算。你可以通过这个链接【8】一键部署。部署完成后,点击访问域名即可进入 inspector 界面。




结语




Cloud Native


至此,你已经成功初始化,开发并部署了一个属于你自己的 SSE MCP Server!除了文章中示范的基于 Node 的 MCP Server Hello World 项目,Serverless Devs 还提供了基于 Python,Java 的 Hello World 项目,以及大量可以一键部署的开源 Server,包括高德地图、百度地图、Github 等等,详情可以查看这个代码仓库【9】

53AI,企业落地大模型首选服务商

产品:场景落地咨询+大模型应用平台+行业解决方案

承诺:免费POC验证,效果达标后再合作。零风险落地应用大模型,已交付160+中大型企业

联系我们

售前咨询
186 6662 7370
预约演示
185 8882 0121

微信扫码

添加专属顾问

回到顶部

加载中...

扫码咨询

扫码登录
登录即表示您同意《53AI网站服务协议》
服务协议

欢迎您使用【53AI 官方网站】(以下简称“本网站”或“我们”)。本《会员服务协议》(以下简称“本协议”)是您(以下简称“会员”或“用户”)与【深圳市博思协创网络科技有限公司】之间关于注册、登录及使用本网站会员服务所订立的法律协议。

在您注册或登录前,请务必审慎阅读、充分理解各条款内容,特别是免除或限制责任的条款、知识产权条款、争议解决条款等。此类条款将以加粗形式提示您注意。 当您通过微信公众号授权、手机验证码验证或其他方式成功登录本网站时,即视为您已完全理解并同意接受本协议的全部内容。

一、 定义

本网站:指由【深圳市博思协创网络科技有限公司】运营的,域名为【53ai.com】的网站及相关移动端页面。

会员服务:指本网站向注册会员提供的知识库文章查阅、内容检索及其他相关增值服务。

知识库内容:指本网站发布的包括但不限于文字、图表、数据、研究报告、行业分析等数字化内容资源。

二、 账号注册与登录

登录方式:本网站支持以下登录方式,您可根据实际情况选择:

微信公众号授权登录:您同意将您的微信OpenID信息授权给本网站,用于创建或关联会员账号。

手机验证码登录:您需提供真实有效的手机号码,并通过短信验证码完成身份验证与登录/注册。

账号安全:您的账号仅限您本人使用,禁止赠与、借用、租用、转让或售卖。因您保管不善导致的账号被盗、密码泄露等损失,由您自行承担。

实名认证:根据相关法律法规要求,我们可能要求您在特定功能下完成实名认证。如您拒绝提供,可能无法使用部分或全部服务。

未成年人保护:若您未满18周岁,请在法定监护人的陪同下阅读本协议,并在征得监护人同意后使用本服务。

三、 服务内容与规范

知识库查阅权限:会员登录后,有权按照其会员等级对应的权限范围,在线浏览、检索本网站知识库中的相关文章及内容。

服务变更:我们有权根据业务发展需要,调整、变更或终止部分服务内容,并将以网站公告、公众号消息等方式提前通知。

禁止行为:您在使用服务时不得实施以下行为:

利用技术手段批量爬取、下载、转存知识库内容;

将知识库内容用于商业目的或未经授权地向第三方传播;

干扰本网站正常运行或侵犯其他用户合法权益;

发布违法违规信息或从事违反公序良俗的活动。

四、 知识产权声明

权利归属:本网站知识库中的排版设计、软件代码等内容的知识产权均归【公司全称】或原权利人所有,受《中华人民共和国著作权法》等法律保护。

有限许可:本网站授予会员一项非独占、不可转让、不可转授权的普通许可,仅限于个人学习、研究之目的在线查阅知识库内容。

侵权追责:未经书面许可,任何单位或个人不得以任何形式复制、转载、摘编、镜像、汇编或以其他方式使用上述内容。一经发现,我们保留追究其法律责任的权利。

五、 个人信息保护

我们重视对您个人信息的保护。关于我们如何收集、使用、存储和保护您的个人信息,请单独阅读 《隐私政策》。

您通过微信公众号授权或手机号验证所提供的信息,我们将严格按照《个人信息保护法》的规定处理,仅用于身份识别、服务提供及安全验证等必要用途。

您可以随时通过网站设置或联系客服行使查阅、更正、删除个人信息及撤回授权同意的权利。

六、 免责声明

内容准确性:知识库内容仅供参考,不构成专业建议。我们不对其完整性、准确性、时效性作任何明示或暗示的保证,您应自行判断并承担使用风险。

不可抗力:因自然灾害、政策法规变化、网络故障、第三方平台接口异常(如微信接口维护、运营商短信通道故障)等不可抗力导致的服务中断或延迟,我们不承担违约责任。

第三方链接:本网站可能包含指向第三方网站的链接,该等网站的内容和服务不受我们控制,请您自行甄别风险。

七、 违约责任

如您违反本协议约定,我们有权视情节采取警告、限制功能、暂停服务、注销账号等措施,并保留要求赔偿损失的权利。

如因您的违约行为导致我们遭受行政处罚、第三方索赔或商誉损失,您应承担全部赔偿责任(包括但不限于罚款、赔偿金、律师费、公证费等)。

八、 法律适用与争议解决

本协议的订立、执行和解释均适用中华人民共和国大陆地区法律。

因本协议产生的或与本协议有关的任何争议,双方应友好协商解决;协商不成的,任何一方均可向【公司所在地】有管辖权的人民法院提起诉讼。

九、 其他

本协议构成双方就本服务达成的完整协议,取代此前任何口头或书面约定。

本协议任一条款被认定为无效或不可执行的,不影响其他条款的效力。

我们对本协议享有最终解释权,并在法律允许的范围内保留随时修改的权利。修改后的协议一经公布即生效,继续使用服务即视为同意修订内容。


已查阅