json我们很熟悉，它的标准就是json schema，目前最广泛版本就是Draft 2020-12 或 Draft 7。

人工智能的mcp主要也使用这个规则，各大ai产品主要参数基本相同，细节参数有所不同，所以掌握通用结构基本就够用。

通用格式

{
  "name": "create_file",
  "description": "创建文件",
  "parameters": {  // <--- 这里直接放 JSON Schema
    "type": "object",
    "properties": {
      "filename": { "type": "string" }
    },
    "required": ["filename"]
  }
}

在mcp中传输的json schema

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {
        "name": "create_file",
        "description": "创建文件",
        "inputSchema": {  // <--- 注意名字叫 inputSchema，但里面完全是标准的 JSON Schema
          "type": "object",
          "properties": {
            "filename": { "type": "string" }
          },
          "required": ["filename"]
        }
      }
    ]
  }
}

核心区别仅在于：
字段名不同: API 通常叫 parameters，MCP 叫 inputSchema。
包装不同: MCP 多了一层 jsonrpc, id, result 等通信协议外壳。
内部逻辑: 完全一致。type: “string” 在任何地方都代表字符串。

其他

文档

json schema官网文档(外网，慢)
https://json-schema.org/understanding-json-schema/reference