mcp-builder

MCP Builder 用于构建可互操作的 MCP 实现，基线为稳定规范 MCP 2026-07-28。核心请求无状态且自包含，不得从传输连接或进程生命周期推断协议版本、客户端能力、身份、会话或任务状态；跨请求状态须通过每个请求携带的显式标识符管理，并协商协议版本与能力。协议分三层：稳定核心（版本、消息模式）、可选核心特性（resources、prompts、tools、elicitation，使用前须声明并检查能力）、扩展（Tasks、Skills over MCP、MCP Apps，需双方显式支持），草稿或厂商扩展应隔离在适配器与特性开关后。架构上使用 JSON-RPC 2.0，传输包括 stdio 与 Streamable HTTP；WebSocket 非标准传输。服务器须实现 server/discover 用于版本与能力发现。Schema 默认 JSON Schema 2020-12，工具参数用对象根、显式必填、窄枚举与 additionalProperties: false，并校验 schema 与每次调用负载；默认禁止网络 $ref 解析，启用时须主机白名单、拒绝回环与私有地址、限制超时与响应大小，并限制 schema 深度与验证时间。安全要求包括同意与最小权限、不信任元数据、输入输出校验、密钥从环境或密钥管理器加载、网络 SSRF 防护、执行隔离与可审计。扩展独立协商，缺失时须优雅降级，不得为功能对等而静默降低安全要求。2026-07-28 弃用 legacy roots、sampling、logging 形态但保留兼容窗口；迁移需替换连接级会话与 initialize 握手、改用无状态每请求元数据、实现 server/discover、将持久状态移至显式句柄、默认升级 Schema 校验、关闭网络 $ref、迁移实验性 Tasks、接受旧 -32002 但发出当前错误语义、旧服务器缺失 resultType 视为 complete。测试覆盖契约、无状态性、Schema 安全、授权、扩展协商、兼容性与失败处理。具体安装命令与代码示例暂未提供。