MCP(Model Context Protocol)模型上下文协议 进阶篇2 - 消息格式和功能

devtools/2025/1/9 3:57:03/
aidu_pl">

在开发前,首先带大家熟悉一下MCP协议的消息格式,和所有可能需要进行协商的功能:

  • MCP协议通过JSON-RPC 2.0规范定义了请求、响应和通知三种消息类型,确保通信的标准化和一致性。
  • 能力协商机制使客户端和服务器能够动态确定支持的协议功能,提升协议的灵活性和扩展性。
  • 子能力的引入进一步细化了功能支持,满足更复杂的应用场景需求。

通过这些机制,MCP协议实现了高效、灵活且可扩展的通信能力,适用于多样化的应用场景。

消息格式

MCP(Message Communication Protocol)中,所有消息都必须遵循JSON-RPC 2.0规范。该协议定义了三种类型的消息:请求(Requests)、响应(Responses)和通知(Notifications)。

请求(Requests)
请求可以从客户端发送到服务器,也可以从服务器发送到客户端。请求的格式如下:

{"jsonrpc": "2.0","id": "string | number","method": "string","params": {"[key: string]": "unknown"}
}
  • 请求必须包含一个字符串或整数类型的ID。
  • 与基础的JSON-RPC不同,ID不能为null。
  • 请求ID在同一会话中不能被重复使用。

响应(Responses)
响应是对请求的回复,其格式如下:

{"jsonrpc": "2.0","id": "string | number","result": {"[key: string]": "unknown"},"error": {"code": "number","message": "string","data": "unknown"}
}
  • 响应必须包含与对应请求相同的ID。
  • 响应必须设置resulterror之一,但不能同时设置两者。
  • 错误代码必须为整数。

通知(Notifications)
通知可以从客户端发送到服务器,也可以从服务器发送到客户端,且不期望得到回复。通知的格式如下:

{"jsonrpc": "2.0","method": "string","params": {"[key: string]": "unknown"}
}
  • 通知不能包含ID。

能力协商

在会话开始时,客户端(Client)和服务器(Server)通过能力协商确定哪些可选的协议功能将被启用。以下是关键能力及其描述:

类别能力描述
Clientroots提供文件系统根目录的能力
Clientsampling支持LLM(大语言模型)采样请求
Clientexperimental支持非标准的实验性功能
Serverprompts提供提示模板(prompt templates)
Serverresources提供可读资源
Servertools暴露可调用的工具
Serverlogging发送结构化日志消息
Serverexperimental支持非标准的实验性功能

能力对象(Capability objects)还可以描述子能力,例如:

  • listChanged:支持列表变更通知(适用于prompts、resources和tools)。
  • subscribe:支持订阅单个项目的变更(仅适用于resources)。

总结

本文详细介绍了MCP(Message Communication Protocol)协议的核心内容,包括消息格式和能力协商机制,所有消息均遵循JSON-RPC 2.0规范。

消息类型

  • 请求(Requests):客户端与服务器之间发送的消息,必须包含唯一ID,且ID不能为null或重复使用。
  • 响应(Responses):对请求的回复,必须包含与请求相同的ID,并返回结果(result)或错误(error),但不能同时设置两者。
  • 通知(Notifications):客户端与服务器之间发送的消息,不期望回复,且不能包含ID。

能力协商
客户端和服务器在会话初期通过能力协商确定可用的协议功能,关键能力包括:

  • 客户端能力:文件系统支持(roots)、LLM采样(sampling)、实验性功能(experimental)。
  • 服务器能力:提示模板(prompts)、资源管理(resources)、工具调用(tools)、日志记录(logging)、实验性功能(experimental)。
  • 子能力:如列表变更通知(listChanged)和资源订阅(subscribe)。

http://www.ppmy.cn/devtools/146606.html

相关文章

音视频入门知识(六):消息获取模式篇

⭐六、消息获取模式篇 推模式(Push Mode) 当通知消息来之时,服务器主动将所有相关信息都通过参数的形式“推给”客户端。客户端无需主动请求数据。 服务端一直监听某个端口,当客户端有数据要发送时,就推到这个端口上给…

数据格式之-XML数据查询语句xpath介绍

很多数据格式都有自己的查询语言,例如数据库的sql语句针对的是数据库格式的增删改查,elastic 的eql针对的是基于elastic产品的格式数据增删改查。那么XML作为一种表示数据的格式,针对XML格式的数据如何进行查询呢? 针对XML数据格…

基于Java2D和Java3D实现的(GUI)图形编辑系统

基于Java2D和Java3D的图形编辑系统 摘 要 基于本学期计算机图形学课程的理解以及课外查找的资料内容,实现了一个基于Java2D及Java3D的图形编辑系统,可以供用户实时交互。基本功能包括二维图形的输入、编辑(裁剪二维变换)、图像存储以及三维图形(.off文…

抓取手机HCI日志

荣耀手机 1、打开开发者模式 2、开启HCI、ADB调试 3、开启AP LOG 拨号界面输入*##2846579##* 4、蓝牙配对 5、抓取log adb pull /data/log/bt ./

一键修复msvcp120.dll-win系统文件错误修复工具

msvcp120.dll 是一个动态链接库(Dynamic Link Library,简称 DLL)文件,它是 Microsoft Visual C Redistributable Packages 的一部分。这个文件主要为在 Windows 操作系统上运行的 C 程序提供必要的运行时代码和库支持。 msvcp120.…

plantuml的picoweb无法渲染分页图表的问题

1. 背景 使用plantuml自带的picoweb在渲染分页图表时,vscode无法换页,但是使用plantuml官网渲染则没问题。查看plantuml官网的picoweb的说明,picoweb只是plantuml服务的最小实现。因此考虑可能是plantuml服务不全导致的上述问题。 2. docke…

Android笔试面试题AI答之非技术问题(3)

Android入门请看《Android应用开发项目式教程》 文章目录 1.你是如何应付项目经理的?**1. 建立清晰的沟通机制****2. 明确项目目标与优先级****3. 制定合理的开发计划****4. 管理项目风险****5. 推动敏捷开发****6. 管理需求变更****7. 提升团队协作****8. 关注项目…

【潜意识Java】深入详细理解分析Java中的toString()方法重写完整笔记总结,超级详细。

目录 一、toString() 方法是啥? (一)默认的 toString() 方法 (二)toString() 方法的作用 二、为啥要重写 toString() 方法? (一)提高代码的可读性 (二)…