SuperAPI AI 工具集

mcp-spec

编程与开发

查看项目

更新于 11-04 18:33

技能介绍

mcp-spec 是一个参考技能(Agent Skill),用途是让智能体在回答或实现 MCP 相关任务时,能够按目录查阅 Model Context Protocol 的规范内容。

【版本与来源】 目标版本为 MCP specification 2026-07-28,对应 GitHub modelcontextprotocol/modelcontextprotocol 的标签 2026-07-28(non-prerelease,published 2026-07-28T16:47:49Z)。正文来源限定为 raw.githubusercontent.com/modelcontextprotocol/modelcontextprotocol/2026-07-28/<path>,不使用 main、draft 或 2026-07-28-RC。无版本号的站点路径(extensions/、registry/、community/)记录获取日期 2026-10-16;由于站点与 .md twin 由 main 构建,不作为正文来源。站点 llms.txt 中 Inspector 子页面与 local-server-security 不存在于该标签,因此未收录。

【范围界定】 本技能只处理协议规范本身。.mcp.json、mcp_servers 等宿主侧配置以及各 SDK 的用法,由 anthropic-claude-code-extend、anthropic-api-tools-mcp、anthropic-agent-sdk、openai-agents、openai-apps-sdk 等宿主技能负责。

【目录与内容】 参考文档分为多个类别,每类含 README 索引:

  • overview:规范概要、架构、Host/Client/Server 概念、版本管理、主要变更、非推荐功能、功能生命周期。
  • base-protocol:消息、响应与错误、无状态性、JSON Schema 使用、_meta 字段、icons、协议版本协商、扩展协商、向后兼容。
  • transports:传输概览、stdio、Streamable HTTP、HTTP 请求头、自定义头、服务器校验、传输向后兼容。
  • authorization:OAuth 授权概览与流程、授权服务器发现、客户端 ID 元数据文档(CIMD)、客户端注册回退、resource 参数、scope 选择、访问令牌使用、授权错误与安全。
  • server-features:服务器概览、discover、tools(定义、结果、错误与状态)、resources(模板、变更通知)、prompts、completion、logging、分页、缓存。
  • client-features:sampling(含带 tools 的 sampling)、elicitation(form 模式、URL 模式)、roots。
  • patterns:模式概览、MRTR、subscriptions、cancellation、progress。
  • extensions:扩展概览、客户端支持矩阵、MCP Apps(含构建)、Tasks、授权扩展、OAuth client credentials、企业托管授权。
  • registry:Registry 介绍、server.json、包类型、远程服务器、Registry 认证、版本管理、聚合器。
  • security:安全最佳实践、confused deputy、token passthrough、SSRF、state handle hijacking、OAuth 重定向攻击、本地服务器侵害、scope 最小化、授权教程。
  • tooling:SDK、Inspector、调试、客户端最佳实践、面向编码助手的 Agent Skills 构建。
  • schema:按方法划分的 JSON-RPC、通用类型、错误、content、discover、tools、resources、prompts、completion、sampling、elicitation、roots、MRTR、subscriptions、notifications 类型定义。 此外,samples/ 提供典型消息交换示例(discover、tools/list 与 tools/call、结构化工具输出、错误响应、Streamable HTTP 交换、MRTR input-required 流程、subscriptions/listen、elicitation、Tasks 扩展、MCP App、授权服务器搭建、OAuth client credentials、Registry 发布 GitHub Actions、Claude Desktop 本地服务器、TypeScript/Python 构建服务器与客户端);scripts/ 提供 SDK 安装、Inspector、调试日志、mcp-publisher 等命令说明。

【使用方式】 使用该技能时,先从任务映射到对应类别(如实现 OAuth 授权查 authorization,确认字段查 schema),再阅读该类别 README.md 定位具体页面,最后读取对应 .md 获取细节;消息示例从 samples/README.md 检索,命令从 scripts/README.md 检索,字段精确性以 references/schema/ 为准。技能本身不提供安装命令或运行方式说明,资料中暂未提供。

【适用场景与限制】 适用于 MCP 协议实现、调试、安全审查、Registry 发布准备、类型字段核对等任务。限制在于:内容固定于 2026-07-28 标签,不覆盖 main/draft 变更;不包括宿主配置与各 SDK 具体用法;资料中未提供价格、平台支持范围或效果说明。