MCP实战篇-部署一个远程MCP服务

前言

大家早上好,我来晚了… 前三期已经给大家介绍了什么是MCP、MCP与LLM函数调用的区别、实现一个简单的本地MCP服务。 传送门:

一文精讲 – MCP与LLM函数调用的区别

MCP实战篇-构建一个MCP服务

探索模型上下文协议(MCP):大型语言模型与外部世界的桥梁

今天来给大家带来如何将一个MCP服务发布到远程服务器,供更多人使用。或者在公司内部提供一个MCP服务进行操作数据库、操作API等,借助LLM的强大能力增效。 当然具体怎么做,还是要看你如何实现这个MCP服务器。


如何实现?本文还是用到上期实现MCP服务的SDK。 在开始之前需要了解一下MCP交互协议(SSE);以及另外一个赛博活菩萨Vercel,它提供我们MCP的运行环境(主要是免费),而且和Github集成非常好,只要我们把代码提交到Github,就自动部署,整个CD做的很方便。



什么是SSE Transport?

MCP(Model Context Protocol) 是一个开放协议,旨在标准化应用程序与大型语言模型(LLM)之间的上下文交互。它定义了客户端与服务器如何通过传输层交换消息。MCP 支持两种标准传输机制:

  • stdio:通过标准输入输出流进行本地通信。
  • SSE(Server-Sent Events):通过 HTTP 协议实现服务器到客户端的实时单向数据推送,结合 HTTP POST 用于客户端到服务器的消息发送。

SSE Transport 是 MCP 中基于 HTTP 的传输方式,利用 SSE 技术实现服务器到客户端的流式消息推送,同时通过 HTTP POST 请求处理客户端到服务器的双向通信。这种机制特别适合需要实时更新或远程通信的场景。


SSE Transport 的工作原理

SSE(Server-Sent Events)是一种基于 HTTP 协议的服务器推送技术,允许服务器向客户端发送实时更新。MCP 的 SSE Transport 结合了 SSE 和 HTTP POST,形成了以下工作流程:

交互流程

1.建立连接:

  • 客户端通过 HTTP GET 请求访问服务器的 SSE 端点(例如 /sse)。
  • 服务器响应一个 text/event-stream 类型的内容,保持连接打开。
  • 服务器发送一个初始的 endpoint 事件,包含一个唯一的 URI(例如 /messages?session_id=xxx),客户端后续通过这个 URI 发送消息。

2.服务器到客户端的消息推送:

  • 服务器通过 SSE 连接将 JSON-RPC 格式的消息以事件流的形式发送给客户端。
  • 客户端通过 EventSource 或类似机制监听这些事件。

3.客户端到服务器的消息发送:

  • 客户端通过 HTTP POST 请求将消息发送到服务器提供的 URI(例如 /messages)。
  • 服务器接收并处理这些请求,返回响应或通过 SSE 推送结果。

4.连接管理:

  • SSE 连接是单向的(服务器到客户端),通常通过定期发送心跳消息(keep-alive)保持活跃。
  • 如果连接断开,客户端可以重新发起 SSE 请求重建连接。

数据格式

SSE 消息遵循 event:\ndata:\n\n 的格式。 MCP 使用 JSON-RPC 2.0 协议封装消息,确保请求和响应的结构化处理

示例

客户端 POST 请求:

  1. POST /messages HTTP/1.1
  2. Content-Type: application/json
  3. {"jsonrpc": "2.0", "method": "example", "params": {"text": "Hi"}, "id": 1}

**服务器推送:

  1. event: message
  2. data: {"jsonrpc": "2.0", "id": 1, "result": {"text": "Hello"}}

Vercel创建项目

Vercel地址:https://vercel.com/, 用Github账号登录即可

创建项目

选择框架


笔者还是选择Python框架

直接部署

这时候会关联你的Github账号对应的仓库,做一下授权即可,笔者之前已经关联过,所以直接展示:
点击Upgrade and Deploy后就可以去Github Clone项目进行下一步操作:代码改造!!🚀🚀🚀
注:因为笔者之前有几个项目了,所以现在只有14天的试用期。


代码改造

因为笔者在前面的文章中已经有代码解释了这里直接贴, 或者去这里查看: https://github.com/PulsarPioneers/mcp-server-example

  1. from mcp.server.fastmcp import FastMCP
  2. from starlette.applications import Starlette
  3. from starlette.routing import Mount, Host
  4. mcp = FastMCP("mcp-server-demo", "MCP Server Example")
  5. @mcp.tool()
  6. def add(a: int, b: int) -> int:
  7.     """
  8.     Adds two numbers.
  9.     """
  10.     return a + b
  11. @mcp.resource("greeting://{name}")
  12. def get_greeting(name: str) -> str:
  13.     """
  14.     Returns a greeting message.
  15.     """
  16.     return f"Hello, {name}!"
  17. app = Starlette(
  18.     routes=[
  19.         Mount('/', app=mcp.sse_app()),
  20.     ]
  21. )
  22. app.router.routes.append(Host('mcp.acme.corp', app=mcp.sse_app()))

提交代码, 去vercel平台等待部署完成,即可测试。


测试

本次使用curl直接测试

笔者vercel平台提供的地址是:mcp-server-example.vercel.app

  1. curl http://localhost:8000/sse


到这里,MCP服务成功。

如果你在实践过程中有任何问题,欢迎留言交流。

(文:PyTorch研习社)

欢迎分享

发表评论