主题
MCP 规范变更日志
本文档记录了 Model Context Protocol 规范的所有重要变更。
[2025-06-18] - 当前稳定版本
新增功能
- 客户端采样: 新增内容采样机制，允许客户端请求特定内容片段
- 引导功能: 增强的用户交互引导系统
- 根目录管理: 改进的文件系统访问控制
- 安全增强: 新的安全最佳实践指南
改进
- 错误处理: 标准化错误响应格式
- 传输层: 优化连接管理和重连机制
- JSON Schema: 更严格的类型定义和验证
- 文档: 全面更新实现指南和示例
修复
- 修复了资源 URI 解析的边界情况
- 改进了工具调用的参数验证
- 解决了并发请求的竞态条件
破坏性变更
- 移除了已弃用的
legacy_*字段 - 更新了初始化握手流程
- 标准化了错误代码定义
[2024-11-05] - 之前版本
新增功能
- 工具集成: 外部工具调用支持
- 资源管理: 统一的资源访问接口
- 提示模板: 动态提示生成系统
改进
- 性能优化: 减少协议开销
- 可靠性: 增强错误恢复机制
- 扩展性: 支持自定义能力声明
修复
- 修复了消息序列化问题
- 改进了连接稳定性
- 解决了内存泄漏问题
版本迁移指南
从 2024-11-05 升级到 2025-06-18
必需变更
更新初始化流程:
json// 旧版本 { "protocolVersion": "2024-11-05" } // 新版本 { "protocolVersion": "2025-06-18", "capabilities": { "roots": { "listChanged": true }, "sampling": {} } }错误处理更新:
json// 新的标准错误格式 { "error": { "code": -32600, "message": "Invalid Request", "data": { "type": "InvalidRequestError", "details": "Missing required field: method" } } }
可选改进
- 实现采样功能: 支持内容片段请求
- 添加引导支持: 增强用户交互体验
- 更新安全实践: 遵循新的安全指南
兼容性注意事项
向后兼容
- 现有的工具和资源调用保持兼容
- 基础消息格式未变更
- 传输层协议保持稳定
不兼容变更
- 移除了
legacy_*字段支持 - 更新了能力声明格式
- 标准化了错误响应结构
未来规划
即将推出 (draft)
- 流式响应: 支持大型内容的流式传输
- 批量操作: 批量工具调用和资源访问
- 高级认证: 增强的身份验证机制
长期目标
- 多语言支持: 国际化和本地化
- 性能监控: 内置性能指标收集
- 插件系统: 可扩展的功能插件架构
贡献指南
提议变更
- 在 GitHub 上创建 Issue 讨论提议
- 遵循 SEP 指南
- 提交详细的技术规范
反馈渠道
- GitHub Issues: 错误报告和功能请求
- 社区讨论: 设计讨论和最佳实践
- 工作组: 参与特定领域的深入讨论