🔗 技术协议

MCP Server Cards(MCP 服务器卡片)

别名:MCP Server CardsServer Card服务器卡片SEP-2127AI Catalog
分类🔗 技术协议
阅读时间⏱️ 14 分钟
更新时间📅 2026-11-21
条目编号ENC-PROTOCOL-26-server-card
MCP Server Cards 是 MCP 扩展轨道提案 SEP-2127 定义的静态元数据文档,用一份 JSON 描述远程 MCP 服务器的身份、连接端点与所支持的协议版本,使客户端在建立连接之前就能完成发现、展示与自动配置。

关键要点 ✦

连接之前的那段空白

据 SEP-2127 的动机说明,MCP 客户端在选择或打开传输之前,缺少一种带外的服务器发现方式。运行时机制如 server/discover 只有在客户端已经知道该连哪里之后才可用,于是形成三段摩擦:用户必须手动把传输 URL 填进配置文件;客户端无法在一个域名下自动发现有哪些服务器;注册表与索引类工具无法在不建立实时连接的条件下抓取与展示服务器信息。

这正是 SEP-2127 要填的空白。提案列出三类被点亮的用法:IDE 扩展在被指向某个域名时可以自行完成配置;客户端与注册表可以爬取域名、建立生态级服务器索引;界面可以在不逐个打开端点的前提下展示服务器信息,降低延迟。把发现做成静态、可缓存、可索引的 HTTP 文档,是这套设计的核心取舍——牺牲实时性以换取可抓取性,再用「连接后以实时值为准」的规则兜底。

卡片里写什么,怎么被找到

据 SEP-2127 与扩展仓库的 schema,卡片必填四项:$schema 指向 schema 地址、name 为反向 DNS 风格的登记名、version 为服务器版本、description 说明用途。可选字段包括给人看的 title、图标、代码仓库、产品页,以及 remotes——一组远端端点声明,每项含传输类型、URL、可选请求头、变量模板与所支持的协议版本。头部取值可以带变量,因此卡片能表达「这里需要一枚 bearer 令牌」而不必真的装着令牌。

发现链路是两层结构。单张卡片可托管在任意未保留 URI,/server-card 为推荐位置,媒体类型为 application/mcp-server-card+json,部署指南建议使用 HTTPS 并配 ETag 等缓存头,同时允许跨源 GET 以便目录与浏览器工具读取。域名级发现另有一个 AI Catalog,发布在 /.well-known/ai-catalog.json,条目以标识符加类型加 URL 的形式指向卡片,也可以直接内嵌卡片数据。规范给出的例子是一张餐厅的多租户场景:餐厅在自己的目录里公布预订平台与招聘平台各自托管的卡片,两个平台则为其服务的每个实体各暴露一张卡片——这解释了为什么卡片不放在 /.well-known 下:一个域名可能同时承载多个 MCP 端点。

为什么把工具清单留在运行时

最值得关注的是刻意不写的那部分。据 SEP-2127 的设计理由,MCP 服务器本质上是动态的:暴露的 primitives 会因认证用户、会话、配置、特性开关与部署状态而不同,静态文档无法可靠表达,目前也没有可行替代品能取代带登录身份的 tools/list、resources/list、prompts/list。过早把 primitives 写进卡片,会不利于动态服务器,也会诱导客户端依赖可能已过时的信息。同理,卡片只声明 supportedProtocolVersions 供客户端判断「能否尝试连接」,而不声明 capabilities 与扩展支持——后者属于协商后的运行时行为。

这套划分让三份文档各归其位:Server Card 回答「这是一台什么服务器、从哪连」,MCP Registry 的 server.json 回答「这个注册表条目怎么装、装本地还是连远端」,server/discover 与握手回答「当前这个连接支持什么」。据安全社区整理,三者出现分歧时应以实时协商结果为准,卡片只是线索。这一条对实现者尤其重要,因为缓存与目录抓取天然会让卡片滞后于服务器实际状态。

生态位置、风险与不确定性

从生态位置看,Server Cards 与本站已收录的 ARD(智能体资源发现规范)都在解发现问题,但层次不同:ARD 面向跨组织的智能体资源,用 OASF 记录与分布式哈希做能力检索,主体是「有哪些智能体/工具可用」;Server Card 是 MCP 自身的服务器连接元数据,主体是「这台服务器的端点与版本」。它与 A2A 的 Agent Card 也不重叠——后者描述智能体的技能与认证要求,前者描述服务器怎么连。

风险同样清楚。卡片由服务器自行发布且可被任意托管,伪造一张声称属于某组织的卡片成本很低;目录抓取会把过期或恶意条目扩散到索引里;卡片里的变量模板若被误用为凭证载体,反而扩大泄露面。可落地的缓解思路是:客户端校验 schema 后再连接、把卡片与实时 server/discover 结果交叉核对、对目录来源做允许列表、把卡片变更纳入监控。

不确定性也要如实标注。据第三方整理,SEP-2127 虽已 Final,扩展在官方索引中仍处于 Beta 且未给出目标阶段;该扩展不属于 2026-07-28 核心规范,客户端支持会滞后;静态 schema 地址在早期一度不可用,需以扩展仓库内的版本为准。目前官方及行业暂未披露更多细节,后续将持续跟进迭代动态。

🎯 应用场景

IDE 与客户端自动配置
用户只给一个域名,客户端读目录与卡片后自行完成端点、版本与请求头配置,免去手填 URL。
生态级服务器索引
注册表与目录站爬取域名下的卡片,建立可搜索的服务器清单,不必逐个建立实时连接。
多租户 SaaS 的端点声明
平台为每个租户实体各发布一张卡片,交由客户域名下的 AI Catalog 汇总,降低跨域连接成本。
企业 MCP 准入清单
以卡片作为服务器身份与端点的事实来源,配合允许列表与来源主机展示,支撑接入评审。

✅ 最佳实践

  • 先校验 schema 再连接,卡片自称的身份、URL 与协议版本都不能作为授权依据。
  • 卡片与实时 server/discover、握手结果冲突时以实时值为准,把卡片当缓存而非事实源。
  • 卡片与目录中不写访问令牌、密钥、租户数据与私有端点,只声明变量占位。
  • 为卡片与目录配置 HTTPS、ETag 与合理的缓存策略,并对变更做监控与告警。
  • 目录条目来源做允许列表,避免爬虫把仿冒或过期卡片扩散进索引。
  • 跟踪扩展阶段而非只看提案状态,Beta 与 Stable 的破坏性变更风险不同。

🔮 未来展望

Server Cards 的现实落地顺序大概率是「目录与爬虫先于客户端原生支持」:注册表、市场与企业内部服务目录改造成本低,收益直接;客户端侧要等扩展从 Beta 走向稳定才会默认信任。中期看,primitive 广告若要进入卡片,需先解决变体枚举与消费者契约两块前置问题;而身份绑定若能与签名、注册表校验打通,卡片才可能从「线索」升级为可验证的准入依据。另一条观察线是它与 A2A Agent Card、ARD 记录之间是否会出现字段级互认,否则智能体世界会同时存在三套描述「谁能提供什么」的方言。

📖 相关条目

🛠️ 相关产品

🏷️ 标签MCP服务发现扩展机制SEP-2127AI Catalog协议设计