rugsnare/docs/blog/2026-10-17-mcp-contract-drift.md at main · Paraphern/rugsnare

📌 One-Sentence Summary
一项为期两个月的审计检查了 24 个热门 MCP 服务器,发现 336 处未事先声明的工具契约变更,包括静默放宽约束和破坏性合并,并提出将固定版本与 schema 差异比对作为 CI 门禁。
📝 Summary
作者固定了 24 个广泛使用的 MCP 服务器的工具契约(名称、描述、inputSchema),并在两个月内对每个版本进行差异比对,覆盖每周约 360 万次安装。审计共发现 336 处契约变更,按方向分级:BREAKING、LOOSENED、EXPANDED、NOTATION 和 COSMETIC。具体案例包括:MongoDB 3.0.0 重新生成了全部 20 个 schema,在 15 处记法层面的变更中隐藏了 5 处真正的收紧,且发布说明为空;Currents 收紧了 45 个 schema 中的 32 个,而维护者辩称后端早已强制执行这些约束;Shopify 和 HubSpot 移除了具体工具,改用通用替代品,导致调用旧工具名的智能体出错;Supabase 迁移了其 stdio 入口点,破坏了固定启动配置;Bybit 强制实施远程清单门禁,阻止经过测试的版本,并在清单服务不可达时跳过验证;GitHub 官方服务器在 v2.0.0 中更改了 131 个工具定义中的 124 个。作者识别出三种反复出现的模式:SDK 迁移引发的记法浪潮、合并式破坏,以及在不破坏任何功能的情况下扩大攻击面的静默放宽。该工具 rugsnare 是开源的,在检测到漂移时以退出码 1 结束,因此可作为 CI 门禁;生态系统正朝着固定版本的方向发展,OWASP 指南和一项 MCP RFC 已纳入这些漂移数据。
💡 Main Points
MCP 工具契约在版本之间静默变化,智能体可能最终遵循用户从未批准过的指令。
工具名称保持稳定,但描述和输入 schema 会变动,这意味着没有可见的破坏,但行为已改变,攻击面也可能扩大。
对 24 个服务器为期两个月的审计发现 336 处契约变更,其中许多是埋在记法变动中的真正收紧。
MongoDB 3.0.0 重新生成了全部 20 个 schema,在 15 处记法层面的变更中隐藏了 5 处真正的约束收紧,而其 GitHub 发布说明为空。
三种反复出现的漂移模式解释了大多数事件:记法浪潮、合并式破坏和静默放宽。
SDK 迁移会大规模重写 schema 字节;供应商用通用工具替换具体工具,导致调用旧名称的智能体出现协议错误;而被移除的约束或放宽的类型扩大了 schema 接受的范围,却没有任何失败信号。
供应商没有可靠的公告渠道,有些还主动阻止用户留在经过测试的版本上。
HubSpot 关联的 GitHub 仓库已失效,而 Bybit 的远程清单门禁在启动时因版本不匹配而退出,其运维团队承认这会阻止用户继续使用经过测试的版本。
固定已批准的契约并在升级时进行差异比对是一种实用且可采用的缓解措施。
开源 CLI 工具 rugsnare 会对每个契约进行规范化并计算哈希,按方向对变更分级,并在检测到漂移时以退出码 1 结束,因此可作为 CI 门禁;OWASP 指南和一项 MCP RFC 已纳入该方法。
💬 Key Quotes
你的智能体现在正在遵循你从未见过、也从未批准过的指令。
你的智能体现在拥有的攻击面比你批准的更宽。
但「供应商应当公告变更」与「消费者能够检测变更」之间的差距,正是漂移藏身之处。
我们理解这会阻止用户继续使用他们已经测试并批准的版本。
这很合理,也恰恰是问题所在:schema 现在会拒绝此前在 schema 层面能够成功的调用,而没有任何发布说明提到这一点。
📊 Article Meta
AI Screening: 86
Source: Hacker News - Newest: "AI Agent"
Author: paraphern
Category: 人工智能
Language: 英文
Read Time: 4 min
Word Count: 902
Tags:
AI 与智能应用 , AI 安全与对齐 , 开发者工具 , 供应链安全 , AI 工程
很有价值的分享,感谢整理。
楼主辛苦了,内容很有参考价值。
作者写得真不错,学到了不少。
这个观点很中肯,深有同感。
这篇文章分析得很透彻,收藏了!
楼主辛苦了,内容很有参考价值。
写得挺用心的,支持一下。
点赞,必须点赞
实话,说的不明不白
作者写得真不错,学到了不少。
楼主辛苦了,内容很有参考价值。
很有价值的分享,感谢整理。