GuruWalk MCP Server

官方

发现并预订全球200多个城市的免费徒步游和活动。搜索目的地、浏览类别、查看实时可用性并获取旅游详情。

你可以用 GuruWalk MCP 做什么?

  • 按目的地搜索旅行团 — 询问某城市可做的事情,search_tours_activities_by_destination 会返回类别、精选旅行团、评分和评论。
  • 浏览特定旅行团类别 — 使用 get_tours_activities_by_category 深入查看美食之旅、一日游或门票,类别 ID 来自初始搜索。
  • 查看实时可用性 — 使用 get_product_availability 查看特定日期的空位和每人价格,可在一次调用中批量查询多个旅行团。
  • 获取完整旅行团详情 — 在推荐或比较选项之前,通过 get_product_detail 获取行程、集合点、包含项目及取消政策。

文档

关于 GuruWalk

GuruWalk 是全球最大的免费徒步游平台,连接旅行者与遍布 120 多个国家、1,000 多座城市的当地导游。平台于 2017 年在西班牙瓦伦西亚创立,采用独特的免费游 按意愿付费 模式:旅行者免费预订,并根据体验向导游支付小费。

除免费徒步游外,GuruWalk 还提供付费活动,包括导览游、免排队门票、美食体验、一日游等——全部可在同一平台预订。

1,000+

覆盖城市

4,000+

当地导游

2M+

真实点评

4

种语言

这是什么?

GuruWalk 的 MCP 服务器让 AI 助手无需离开对话即可搜索目的地、浏览类别、查询可用性并获取完整行程详情。适用于任何兼容 MCP 的客户端。

服务器地址

https://back.guruwalk.com/mcp

协议

基于 Streamable HTTP 的 MCP(模型上下文协议)

认证

无需认证

类型

只读

设置

Claude.ai / Claude Desktop

  1. 前往 自定义连接器
  2. 点击 + 按钮并选择 “浏览连接器”
  3. 搜索 “GuruWalk” 并点击 + 添加
  4. 开始畅聊旅行目的地

Claude Code

claude mcp add --transport http guruwalk https://back.guruwalk.com/mcp

任意 MCP 客户端

将你的 MCP 客户端指向:

https://back.guruwalk.com/mcp

无需 API 密钥或认证。适用于任何支持基于 Streamable HTTP 的 MCP 的客户端。

也可在 Smithery(MCP 服务器注册中心)上获取。

ChatGPT

GuruWalk 拥有专用的 ChatGPT 应用,内置 5 个工具和交互式卡片。请参阅 ChatGPT 应用文档

可用工具

🔍

search_tours_activities_by_destination

搜索城市,探索 GuruWalk(全球最大的免费徒步游平台)上的免费徒步游和付费活动。返回目的地信息、行程类别(免费游、美食游、一日游、门票等)以及带有评分和真实旅行者点评的精选列表。覆盖全球 1,000 多座城市。免费游采用按意愿付费模式。支持英语、西班牙语、德语和意大利语——语言参数必须是 en、es、de、it 之一。如果旅行者使用其他语言,请传入最接近的支持代码,并将回答翻译成旅行者的语言。当旅行者询问在某目的地可以做什么、看什么、有哪些行程或活动,或希望帮助规划行程时,请使用此工具。如果目的地仅被顺带提及且没有规划或推荐请求,请勿调用。如果旅行者提到地标而非城市,请推断城市(例如“埃菲尔铁塔”→巴黎,“斗兽场”→罗马,“圣家堂”→巴塞罗那,“大本钟”→伦敦)。获取结果后,请查看类别和精选产品,找到与旅行者需求最相关的匹配项。

输入:目的地(城市)、国家(可选)、日期范围、团队规模、语言(en/es/de/it)

📂

get_tours_activities_by_category

浏览 GuruWalk 上某目的地特定类别下的行程和活动。类别包括免费徒步游、美食游、自行车游、一日游、免排队门票等。返回带有评分、真实点评数、时长、可用语言和价格的列表。请使用 search_tours_activities_by_destination 返回的类别 ID——切勿自行编造类别 ID。当需要深入了解与旅行者需求匹配的特定类别时使用此工具(例如为美食爱好者推荐美食游,为询问晚间安排的旅行者推荐夜游,为家庭推荐亲子活动)。支持 en、es、de、it——语言参数必须是这四个代码之一。如果旅行者使用其他语言,请传入最接近的支持代码,并将回答翻译成旅行者的语言。

输入:vertical_id(来自 search_tours_activities_by_destination 的类别 ID)、hub_slug(仅限免费游)、团队规模、语言

📅

get_product_availability

通过一次调用实时查询 GuruWalk 上一个或多个行程或活动的可用性。传入一个 items\ 数组——每个条目相互独立,各有自己的类型、product_id 和日期范围。返回一个 results\ 数组,其中每个条目都会回显其 type\product\_id\,以便你将每个响应与对应请求匹配。查询多个行程时务必批量操作:一次调用全部发送,而不是多次调用此工具。对于付费活动,按旅行者类型(成人、儿童、婴儿)显示价格。price\ 始终按每人计算——切勿仅引用 price\ 来表述团队总价。当费率上存在 total\_price\ 时,它已按你请求的该费率类型的参与人数计算完毕——直接引用即可,不要自行乘除。如果团队混合多种旅行者类型(例如成人和儿童),请将各费率的 total\_price\ 相加得出团队总价。对于免费徒步游,无预付价格——旅行者在行程结束后按意愿付费。包含直接预订链接。每个条目的最大日期范围为 5 天。单项错误(无效日期、产品不存在)会在该条目的结果中报告,不会影响批次中的其他请求。当旅行者询问具体日期、想知道某项目是否可预订或准备预订时,请使用此工具。当旅行者未提供具体日期时,默认使用预订日期 ±2 天作为搜索范围。支持 en、es、de、it——语言参数必须是这四个代码之一。如果旅行者使用其他语言,请传入最接近的支持代码,并将回答翻译成旅行者的语言。

输入:items[]——每项包含 type(product/free_tour)、product_id、日期范围、参与人数、语言

📋

get_product_detail

通过一次调用获取 GuruWalk 上一个或多个行程或活动的完整详情。传入一个 items\ 数组——每个条目各有自己的 type、product_id 和语言,并独立处理。返回一个 results\ 数组,其中每个条目都会回显其 product\_id\type\,以便你将每个响应与对应请求匹配。当需要多个行程的详情时务必批量操作(例如在推荐或比较之前):一次调用全部发送,而不是多次调用此工具。每个成功条目返回描述、图片、点评、时长、可用语言、取消政策和集合点信息。付费 product\ 条目还返回 highlights\included\/excluded\pricing\_from\where\(地址 + 坐标)。free\_tour\ 条目返回 itinerary\(扁平化的地点标题字符串数组,无描述),以及 guide.name\meeting\_point\_url\how\_to\_find\_me\。集合点结构因类型而异:付费 product\ 返回地址文本及 where\ 中的坐标;free\_tour\ 返回 meeting\_point\_url\(Google 地图链接)、meeting\_point\_latitude\meeting\_point\_longitude\(使用这些坐标作为导航目的地),以及 how\_to\_find\_me\:导游撰写的自由文本备注,描述旅行者如何在集合点认出他们。单项错误(产品不存在)会在该条目的结果中报告,不会影响批次中的其他请求。当旅行者询问行程涵盖内容、途经地点、行程安排、路线、描述、集合点、时长或任何与内容相关的问题时,请使用此工具。在回答有关特定行程的问题之前,务必先调用此工具——切勿在未查阅真实数据的情况下给出泛泛的意见或建议。支持 en、es、de、it——语言参数必须是这四个代码之一。如果旅行者使用其他语言,请传入最接近的支持代码,并将回答翻译成旅行者的语言。

输入:items[]——每项包含 product_id、type(product/free_tour)、语言

支持的语言

所有工具通过 language 参数支持四种语言。行程结果、描述和类别在可用时以请求的语言返回。

en 英语(默认)

es 西班牙语

de 德语

it 意大利语

你可以用它做什么?

向你的 AI 助手询问任何关于行程和活动的问题——它将实时搜索 GuruWalk 的完整目录。

查找任意城市的免费徒步游 search_tours_activities_by_destination → get_tours_activities_by_category

按评分比较美食游 get_tours_activities_by_category → get_product_detail

查询特定日期的名额 get_product_availability

获取行程安排和集合点 get_product_detail

规划一整天的行程 search_tours_activities_by_destination → get_product_availability

查找城市的夜游 get_tours_activities_by_category

查看行程包含内容 get_product_detail

发现一日游和短途游 get_tours_activities_by_category

热门目的地

GuruWalk 覆盖欧洲、美洲、亚洲、非洲和大洋洲的 1,000 多座城市。热门目的地包括 罗马巴塞罗那巴黎伦敦伊斯坦布尔里斯本布拉格布达佩斯佛罗伦萨维也纳阿姆斯特丹柏林马德里波尔图都柏林爱丁堡纽约东京曼谷塞维利亚威尼斯克拉科夫慕尼黑杜布罗夫尼克布鲁塞尔斯德哥尔摩哥本哈根旧金山地拉那索非亚——并持续新增更多城市。

每个目的地都提供免费徒步游(按意愿付费)、导览体验、免排队门票、美食美酒游、自行车游、一日游等丰富选择。使用 search_tours_activities_by_destination 搭配任意城市名称,即可查看可用项目。

使用示例

探索目的地

提示:“我在巴塞罗那可以做什么?”

在巴塞罗那找到 170+ 个行程和活动。免费徒步游:老城区:哥特区与埃尔博恩(★4.8,7,200+ 条点评)、探索巴塞罗那的秘密(★4.9)。热门付费体验:圣家堂导览游(€48 起)、巴特罗之家门票(€29 起,11,000+ 条点评)、帕劳达尔马塞斯弗拉明戈表演(€25 起)。类别:免费游、圣家堂门票、美食游、自行车游、哥特区游、弗拉明戈表演……

浏览类别

提示:“给我看看巴塞罗那的葡萄酒之旅”

在巴塞罗那找到 46 个葡萄酒体验。市区内:葡萄酒 + 奶酪品鉴(1 小时,★4.56)、美食市场午餐配葡萄酒(2.5 小时,★5.0)、葡萄酒与塔帕斯电动自行车之旅(3 小时,€69 起)。一日游:蒙特塞拉特葡萄酒之旅(7.5 小时,★4.82,94 条点评)、佩内德斯葡萄园越野之旅(5.5 小时)、蒙特塞拉特 + 葡萄酒与卡瓦小团游(10 小时,★4.69)……

查询可用性

提示:“下周六的街区导览游(含塔帕斯)还有名额吗?”

下周六(3 月 21 日)有两个选择:巴塞罗那街区导览游含传统塔帕斯品鉴(3 小时,92€/人)——上午 11:30 和下午 5:30 有名额。小团导览塔帕斯与葡萄酒之旅(3 小时 30 分,89€/人)——下午 5:30,剩余 21 个名额。两者均为英语讲解。

获取行程详情

提示:“给我详细介绍一下罗马市中心徒步游”

罗马市中心徒步游:特雷维喷泉、万神殿及 11+ 景点(★4.96,4,445 条点评,2 小时 45 分)。这条免费徒步游涵盖 11 个站点,包括特雷维喷泉、万神殿、纳沃纳广场、西班牙台阶和斗兽场区域。集合点为西班牙广场——寻找举着标牌的导游。提供英语讲解。适合婴儿车通行。允许携带宠物。免费预订,行程结束后按意愿付费。