规范(2024-11-05)
ℹ️
协议版本: 2024-11-05
模型上下文协议(MCP)是一个开放协议,它使 LLM 应用程序与外部数据源和工具之间能够无缝集成。无论您是构建 AI 驱动的 IDE、增强聊天界面,还是创建自定义 AI 工作流,MCP 都提供了一种标准化的方式将 LLM 与它们所需的上下文连接起来。
本规范定义了权威的协议要求,基于 TypeScript 模式 schema.ts。
有关实现指南和示例,请访问 mcpcn.com。
本文档中的关键词"必须"(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 本身不能在协议级别强制执行这些安全原则,但实现者应该:
- 在其应用程序中构建健壮的同意和授权流程
- 提供清晰的安全影响文档
- 实施适当的访问控制和数据保护
- 在集成中遵循安全最佳实践
- 在功能设计中考虑隐私影响
了解更多
浏览每个协议组件的详细规范: