2024-11-05
规范
模型上下文协议(MCP)是一个开放协议,支持 LLM 应用程序与外部数据源和工具之间的无缝集成。无论您是构建 AI 驱动的 IDE、增强聊天界面,还是创建自定义 AI 工作流程,MCP 都提供了一种标准化的方式,将 LLM 与所需的上下文连接起来。
本规范基于 schema.ts 中的 TypeScript 模式,定义了权威的协议要求。
有关实现指南和示例,请访问 modelcontextprotocol.io。
本文档中的关键词“MUST”、“MUST NOT”、“REQUIRED”、“SHALL”、“SHALL NOT”、“SHOULD”、“SHOULD NOT”、“RECOMMENDED”、“NOT RECOMMENDED”、“MAY”和“OPTIONAL”应按照 BCP 14 [RFC2119] [RFC8174] 的描述进行解释,仅当它们以全大写形式出现时,如此处所示。
概览
MCP 为应用程序提供了一种标准化的方式,用于:
- 与语言模型共享上下文信息
- 向 AI 系统暴露工具和能力
- 构建可组合的集成和工作流程
该协议使用 JSON-RPC 2.0 消息格式,在以下角色之间建立通信:
- 宿主:发起连接的 LLM 应用程序
- 客户端:宿主应用程序内的连接器
- 服务器:提供上下文和能力的服务
MCP 部分灵感来源于 语言服务器协议,后者标准化了如何在整个开发工具生态系统中添加编程语言支持。类似地,MCP 标准化了如何将额外的上下文和工具集成到 AI 应用程序生态系统中。
关键细节
基础协议
- JSON-RPC 消息格式
- 有状态连接
- 服务器和客户端能力协商
功能
服务器向客户端提供以下功能之一:
- 资源:供用户或 AI 模型使用的上下文和数据
- 提示:为用户提供的模板化消息和工作流程
- 工具:供 AI 模型执行的函数
客户端可以向服务器提供以下功能:
- 采样:服务器发起的代理行为和递归 LLM 交互
附加工具
- 配置
- 进度跟踪
- 取消操作
- 错误报告
- 日志记录
安全与信任
模型上下文协议通过任意数据访问和代码执行路径实现了强大的功能。随之而来的是所有实现者必须谨慎处理的重要安全和信任考虑。
关键原则
-
用户同意和控制
- 用户必须明确同意并理解所有数据访问和操作
- 用户必须保留对共享数据和执行操作的控制权
- 实现者应提供清晰的 UI 以供审查和授权活动
-
数据隐私
- 宿主必须在向服务器暴露用户数据前获得明确的同意
- 宿主不得未经用户同意将资源数据传输到其他地方
- 用户数据应通过适当的访问控制得到保护
-
工具安全
- 工具代表任意代码执行,必须谨慎对待
- 宿主必须在调用任何工具前获得明确的同意
- 用户应在授权使用工具前了解每个工具的功能
-
LLM 采样控制
- 用户必须明确批准任何 LLM 采样请求
- 用户应控制:
- 是否进行采样
- 将发送的实际提示
- 服务器可以看到的结果
- 协议有意限制服务器对提示的可见性
实现指南
虽然 MCP 本身无法在协议层面强制执行这些安全原则,但实现者 应该:
- 在其应用程序中构建稳健的同意和授权流程
- 提供清晰的安全影响文档
- 实施适当的访问控制和数据保护
- 在其集成中遵循安全最佳实践
- 在功能设计中考虑隐私影响
了解更多
探索每个协议组件的详细规范: