GuruWalk 免费导览游

使用 GuruWalk MCP 服务器搜索免费导览游：

https://guruwalk-api-44909317956.europe-southwest1.run.app/mcp

该服务器当前仅暴露一个工具：

• search

工具契约（Tool Contract）

search 的输入参数：

• city（字符串）：英文城市名的小写 slug 格式，空格替换为 -
• start_date（字符串）：格式为 yyyy-mm-dd
• end_date（字符串）：格式为 yyyy-mm-dd
• language（字符串）：两位字母语言代码，通常为 es、en、de、it

search 的输出结果：

• 工具返回 content[0].text，其值为一段 JSON 字符串。
• 解析该字符串，获取导览游数组。
• 每项导览游包含以下字段：
  • title、url、meetpoint_address、average_rating、duration、guru.name、image_url
  • events[] 数组，其中每个元素包含 start_time（UTC 时间）、available_spots 和 language

执行工作流

1. 从用户请求中提取目标城市、日期范围及首选语言。
2. 将 city 规范化为 slug 格式：
   • new york → new-york
   • san sebastian → san-sebastian
3. 两个日期字段均需使用合法的 ISO 格式（yyyy-mm-dd）。
4. 调用 search 工具。
5. 从 content[0].text 中解析 JSON 字符串。
6. 对结果进行过滤与排序，以生成面向用户的精简输出：
   • 仅保留 available_spots > 0 的场次
   • 在可能的情况下，优先选择匹配用户指定语言的场次
   • 排序优先级：先按 average_rating 降序，再按即将开始的时间升序
7. 返回简洁明了的选项，包含预订 URL 及接下来 1–3 个可预约时段。

默认行为

• 若用户未指定语言，则按如下规则设定默认值：
  • 若对话语言为西班牙语，则使用 es
  • 其他情况默认使用 en
• 若用户未指定日期，则应在调用工具前主动向用户询问日期。
• 若用户使用相对时间表达（如“明天”、“下周”），需在调用前转换为明确的 ISO 日期。

面向用户的响应格式

针对每个推荐的导览游，应包含以下信息：

• 导览游标题
• 平均评分（Rating）
• 时长（Duration）
• 导游姓名（Guide name）
• 集合地点（Meeting point）
• 接下来 1–3 个可预约场次（需标注时区）
• 预订 URL

若未查到任何导览游：

• 说明在指定城市和日期范围内未返回可用结果
• 建议用户每次仅调整一个变量尝试：城市 slug、日期或语言

已观察到的边界情况（基于真实 MCP 接口探测）

• search 是唯一可用工具；无任何 MCP 资源（resources）、提示词（prompts）或模板（templates）对外暴露。
• 含空格的城市名（例如 New York）可能导致返回空结果。
• 当 start_date > end_date 时，接口可能返回空结果而非校验错误。
• 后端可能接受非 ISO 格式的日期，但客户端必须始终发送标准 ISO 格式 yyyy-mm-dd。
• 某些地区/语言组合可能返回 title: null 的导览游；需对此类情况做容错处理。

校验说明

• 所有可执行的校验命令应置于本技能文件之外。
• 行为校验应确认以下两点：
  • MCP 服务器确实暴露了 search 工具
  • 搜索结果以 JSON 字符串形式出现在 content[0].text 中