MCP协议2025强制实施：Server必须实现health与schema接口

想用AI Agent跑通真实业务链路？别再被“工具连不上”卡住三天。

2025年6月起，MCP主仓（`modelcontextprotocol/mcp`）将强制所有Server实现两个接口：  
✅ `/mcp/server/health` —— 返回 `{"status": "ok", "version": "1.2.0"}`  
✅ `/mcp/server/schema` —— 返回完整OpenAPI 3.1 Schema，包含全部tool定义、输入输出类型、required字段

这不是新增功能，是协议落地的硬性门槛。

过去三个月，我们在龙虾平台接入47个第三方MCP Server（Notion Sync、飞书审批Bot、本地Python沙箱等），83%的集成失败原因一致：开发者手动拼接tool call payload，却不确定对方实际接受的字段名是`file_id`还是`document_uuid`，类型是`string`还是`integer`，是否允许`null`。调试靠试，上线靠运气。

现在，`/mcp/server/schema`提供机器可读的契约。一行curl就能验证：

curl -s https://your-server.com/mcp/server/schema | jq '.components.schemas.ExecuteToolRequest.properties.tool_input'

输出明确告诉你：  
- `tool_input` 是 `object`，必填字段为 `["task_id", "timeout_sec"]`  
- `task_id` 类型为 `string`，格式 `uuid`  
- `timeout_sec` 类型为 `integer`，默认值 `30`，最大值 `120`

实际价值体现在：  
🔹 **Agent开发**：A2A路由层可自动生成type-safe调用，不再手写JSON；  
🔹 **插件市场**：用户安装前一键验证协议兼容性（龙虾插件商店已内置）；  
🔹 **自动化落地**：CI中加入`mcp-validate --url https://prod.example.com`，阻断不合规Server上线；  
🔹 **商业交付**：客户验收时，`health + schema`就是SLA承诺的原子证据——不是“能跑”，而是“契约级稳定”。




👉 <a href="https://idsoo.com/go/binance.html" rel="nofollow noopener" target="_blank">Binance</a> · <a href="https://idsoo.com/go/okx.html" rel="nofollow noopener" target="_blank">OKX</a> · <a href="https://idsoo.com/go/gate.html" rel="nofollow noopener" target="_blank">Gate.io</a> · <a href="https://idsoo.com/go/htx.html" rel="nofollow noopener" target="_blank">HTX</a> · <a href="https://idsoo.com/go/bitget.html" rel="nofollow noopener" target="_blank">Bitget</a>

OpenClaw v0.8已默认启用schema introspection。新建MCP Server只需继承`BaseMCPHandler`，健康检查和schema端点自动注入：

from openclaw import BaseMCPHandler, Tool

class MyDBTool(Tool):

name = "query_user_orders"
description = "Query user orders by email"
input_schema = {"email": {"type": "string", "format": "email"}}

class MyServer(BaseMCPHandler):

tools = [MyDBTool]

if name == "__main__":

server = MyServer()
server.run(port=8000)  # 自动暴露 /mcp/server/health & /mcp/server/schema

部署后，`curl http://localhost:8000/mcp/server/schema` 直接返回完整OpenAPI文档，零配置。

这背后没有玄学。MCP正从“能用协议”转向“生产协议”——就像HTTP/1.1强制要求`Host`头一样，健康检查和schema是跨组织协作的基础设施底线。不提供，你的Agent在别人系统里就是黑盒；提供，你的工具才能成为生态里的标准零件。

龙虾官网yitb.com已上线「MCP Compliance Checker」（免费）：粘贴Server地址，3秒返回兼容性报告+缺失项修复指南。《MCP Server开发清单》v2.1同步更新，含Docker健康探针配置、K8s readinessProbe写法、Schema生成避坑要点（例如`$ref`必须用绝对URL）。

**下一步行动**：  
👉 今天打开你的MCP Server代码，加两行健康检查（[参考模板](https://yitb.com/mcp-health-template)）；  
👉 运行 `openclaw schema-gen --output schema.json` 生成并部署`/mcp/server/schema`；  
👉 去[yitb.com/mcp-checker](https://yitb.com/mcp-checker) 输入服务地址，拿回第一份合规报告。  
不是“以后做”，是今晚10点前做完。MCP不等你。