使用原生http请求mcp服务器示例

使用原生http请求mcp服务器示例

本文使用PostMan直接发送http请求来访问mcp服务器,以从底层了解mcp生命周期和通信机制。mcp服务端使用spring-ai搭建,PostMan请下载最新版本。

一、SSE

服务端搭建

完整代码仓库地址:https://gitee.com/heartdance/spring-ai-mcp-server-demo

请求示例

整体结构为长连接接收响应+短连接发送请求模式。

  • 连接a为长连接,客户端发送GET请求到服务端sse端点建立,建立后持续监听sse响应流。
  • 连接b、c、d...为短连接,客户端发送POST请求到服务端消息端点,服务端收到请求后,返回空响应,并将实际请求结果通过sse推送给连接a。

下面是一个请求工具列表并执行工具的示例。

  1. GET请求访问sse端点,建立sse长连接
    GET /sse

    可见服务端通过sse推送endpoint事件,后续POST请求的端点使用此事件值。

  2. POST请求发送初始化请求
    POST /mcp/message?sessionId=a1fb597d-11bf-48da-b66d-0729982daa2f

    json 复制代码
    {"jsonrpc":"2.0","id":0,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"ExampleClient","version":"1.0.0"}}}

    发送初始化请求后,服务端返回空响应,并推送实际初始化结果到sse长连接。切换到sse长连接,可见已经收到服务端发来的初始化结果推送,如下所示。

    1. POST请求发送初始化完成通知请求
      POST /mcp/message?sessionId=a1fb597d-11bf-48da-b66d-0729982daa2f
    json 复制代码
    {"jsonrpc":"2.0","method":"notifications/initialized"}

    通知类请求不会有实际结果,所以sse长连接不会收到新的推送。

  3. POST请求发送获取工具列表请求
    POST /mcp/message?sessionId=a1fb597d-11bf-48da-b66d-0729982daa2f

    json 复制代码
    {"jsonrpc":"2.0","id":1,"method":"tools/list"}

    发送获取工具列表请求后,服务端返回空响应,并推送工具列表结果到sse长连接。切换到sse长连接,可见已经收到服务端发来的工具列表,包含getCurrentDateTime工具,如下所示。

  4. POST请求发送执行工具请求
    POST /mcp/message?sessionId=a1fb597d-11bf-48da-b66d-0729982daa2f

    json 复制代码
    {"jsonrpc":"2.0","id":2,"method":"tools/call","params": {"name": "getCurrentDateTime"}}

    发送执行工具getCurrentDateTime请求后,服务端返回空响应,并推送执行结果到sse长连接。切换到sse长连接,可见已经收到服务端发来的执行结果,类型为text,值为"2025-09-25T11:32:14.310873100+08:00[Asia/Shanghai]",如下所示。

至此,已经完成整个生命周期的请求示例,后续只要sse长连接未断开,可以继续通过POST发送请求并通过sse长连接接收响应。但是到这里应该也能够看出sse模式的局限性了,比如需要维持长连接占用服务器资源、强制使用会话id不利于水平拓展、请求响应分属不同连接增加客户端复杂度等,所以更高效的Streamable HTTP模式应运而生。

二、Streamable HTTP

由于spring-ai正式版尚未支持Streamable HTTP,等待1.1.0正式版发布后再更新这部分。

三、参考文献

  1. mcp官方文档,https://modelcontextprotocol.io/
  2. spring-ai官方文档,https://docs.spring.io/spring-ai/reference/api/mcp/mcp-overview.html
相关推荐
万俟淋曦14 小时前
【论文速递】2025年第30周(Jul-20-26)(Robotics/Embodied AI/LLM)
人工智能·深度学习·ai·机器人·论文·robotics·具身智能
默 语15 小时前
AI驱动软件测试全流程自动化:从理论到实践的深度探索
运维·人工智能·驱动开发·ai·自动化·ai技术·测试全流程
CoderJia程序员甲15 小时前
GitHub 热榜项目 - 日榜(2025-10-18)
ai·开源·大模型·github·ai教程
后端小张19 小时前
[AI 学习日记] 深入解析MCP —— 从基础配置到高级应用指南
人工智能·python·ai·开源协议·mcp·智能化转型·通用协议
测试开发技术19 小时前
什么样的 prompt 是好的 prompt?
人工智能·ai·大模型·prompt
Jing_jing_X20 小时前
微信小程序开发踩坑记:从AI工具翻车到找到合适方案
人工智能·ai·小程序·产品运营·个人开发
迦蓝叶21 小时前
JAiRouter v1.0.0 正式发布:企业级 AI 服务网关的开源解决方案
java·运维·人工智能·网关·spring·ai·开源
长空任鸟飞_阿康21 小时前
Node.js 核心模块详解:fs 模块原理与应用
前端·人工智能·ai·node.js
武子康21 小时前
AI-调查研究-106-具身智能 机器人学习数据采集工具和手段:传感器、API、遥操作、仿真与真人示教全流程
人工智能·深度学习·机器学习·ai·系统架构·机器人·具身智能
武子康1 天前
AI-调查研究-107-具身智能 强化学习与机器人训练数据格式解析:从状态-动作对到多模态轨迹标准
人工智能·深度学习·机器学习·ai·系统架构·机器人·具身智能