// MCP 里，一个工具会这样"自我介绍"（示意，实际字段更细）
{
  "name": "query_database",
  "description": "按 SQL 查询公司数据库并返回结果",
  "inputSchema": {                 // 告诉 Agent：调我要传什么
    "type": "object",
    "properties": { "sql": { "type": "string" } },
    "required": ["sql"]
  }
}
// Agent 一读这份"说明书"，就知道这个工具能干嘛、怎么调——不用你写死适配

✋ 动手 10 分钟：给一个工具写"MCP 风格说明书"

MCP 的灵魂是"工具自带一份机器能读懂的说明书"。不接真服务，先练"把一个工具描述成结构化 schema"的手感：

import json

# 想象你要把"查天气"这个能力，做成一个能被任何 Agent 即插即用的工具
# 关键：把"叫什么、干什么、要传什么参数"写成结构化说明书
weather_tool = {
    "name": "get_weather",
    "description": "查询指定城市今天的天气",
    "inputSchema": {                        # 告诉 Agent 调用时要传什么
        "type": "object",
        "properties": {
            "city": {"type": "string", "description": "城市名，如 北京"}
        },
        "required": ["city"],               # city 必须传
    },
}

# 打印出来看看——任何懂 MCP 的 Agent 读到这份 JSON，就知道怎么调你
print(json.dumps(weather_tool, ensure_ascii=False, indent=2))

# 练习：再给"发邮件 send_email"写一份（参数：to、subject、body）
# 体会：写清楚 schema，就是 MCP 让工具"即插即用"的秘诀