构建我的第一个 MCP 服务器:西班牙天气 API 与它的两步陷阱
来源:dev.to — Jul 25-26
📋 概述
一位从 Java/Spring 转向 AI 工程的后端工程师记录了他构建第一个 MCP 服务器的经历。西班牙气象局 AEMET 的 API 有一个特殊设计:先请求获取数据 URL,再请求该 URL 获取实际数据。这个两步调用模式恰好暴露了 MCP 工具设计中关于异步调用和错误处理的核心设计决策。
🔑 核心要点
- AEMET API 的两步调用模式(先拿令牌 URL,再拿数据)要求 MCP 工具支持链式调用——一个 tool 的输出是另一个 tool 的输入。
- MCP 的 tool 粒度设计是第一道决策:是把两步封装成一个粗粒度工具,还是暴露两个细粒度工具由 LLM 编排?
- TypeScript 实现 MCP 服务器时,Zod schema 定义同时承担输入验证和 LLM function calling 参数说明的双重角色。
💡 金句
最难的从来不是协议本身,而是决定一个 tool 从哪开始、到哪结束。
👍 0
👎 0
← 返回 Dev.to 首页