GuruWalk MCP Server

官方

探索並預訂全球200多個城市的免費徒步導覽與活動。搜尋目的地、瀏覽分類、查看即時名額,並取得行程詳細資訊。

你可以用 GuruWalk MCP 做什麼?

  • 按目的地搜尋行程 — 詢問某城市可從事的活動,search_tours_activities_by_destination 會回傳類別、精選行程、評分與評論。
  • 瀏覽特定行程類別 — 使用初次搜尋取得的類別 ID,透過 get_tours_activities_by_category 深入探索美食之旅、一日遊或門票。
  • 查看即時供應情況 — 使用 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

通訊協定

MCP(模型上下文協定),透過 Streamable HTTP

驗證

無需驗證

類型

唯讀

設定

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 金鑰或驗證。適用於任何支援 MCP over Streamable HTTP 的用戶端。

也可在 Smithery(MCP 伺服器註冊表)上取得。

ChatGPT

GuruWalk 有專屬的 ChatGPT App,內含 5 個工具與互動式卡片。請參閱 ChatGPT App 文件

可用工具

🔍

search_tours_activities_by_destination

搜尋城市,探索 GuruWalk(全球最大的免費步行導覽平台)上的免費步行導覽與付費活動。回傳目的地資訊、導覽分類(免費導覽、美食導覽、一日遊、門票等),以及附評分與真實旅客評論的精選清單。涵蓋全球 1,000 多個城市。免費導覽採隨喜付費模式。支援英文、西班牙文、德文與義大利文——語言參數必須是 en、es、de、it 其中之一。若旅客使用其他語言,請傳入最接近的支援代碼,並將答案翻譯成旅客的語言。當旅客詢問在某目的地可以做什麼、看什麼、有哪些導覽或活動,或需要協助規劃行程時,請使用此工具。若目的地僅被順帶提及而無規劃或推薦需求,請勿呼叫。若旅客提到地標而非城市,請推斷城市(例如「艾菲爾鐵塔」→ 巴黎、「羅馬競技場」→ 羅馬、「聖家堂」→ 巴塞隆納、「大笨鐘」→ 倫敦)。取得結果後,請檢視分類與 featured_products,找出與旅客需求最相關的項目。

輸入:目的地(城市)、國家(選填)、日期範圍、人數、語言(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\ 陣列——每個項目各自獨立,有自己的 type、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 個停靠點,包括特雷維噴泉、萬神殿、納沃納廣場、西班牙階梯與羅馬競技場周邊。集合地點在西班牙廣場——尋找持標誌的導遊。提供英文導覽。嬰兒車可通行。寵物友善。免費預訂,結束後隨喜付費。