Ferryhopper MCP Server

官方

Ferryhopper MCP Server 提供渡輪航線、時刻表及預訂導流功能,讓 AI 助手能查詢歐洲與地中海的航線資訊,並引導使用者前往 Ferryhopper 完成預訂。

你可以用 Ferryhopper MCP 做什麼?

  • 搜尋多段渡輪行程 — 透過 search_ferry_trips 查詢單程、來回或跳島行程,最多可包含 5 段航程。
  • 取得詳細航行資訊 — 使用 trip_details 要求特定行程的船隻規格、設施、照片,以及可預訂的艙房/座位選項。
  • 探索港口與直達航線 — 透過 get_ports 找出所有渡輪港口,或使用 get_direct_connections_for_ports 列出從某出發地可直達的目的地。
  • 查詢即時中斷資訊 — 使用 get_disruptions 詢問某國家與日期的延誤、取消或天氣警報。
  • 取得預訂轉介連結 — 接收直接的 Ferryhopper.com URL,以完成所選行程的預訂。

文件

供 AI 助理使用的渡輪航線、時刻表與訂票轉接

Ferryhopper MCP Server 提供渡輪航線、時刻表與訂票轉址功能,讓 AI 助理能夠探索歐洲及地中海地區的航線,並引導使用者前往 Ferryhopper 完成訂票。

主要功能

🌍

港口與航線

搜尋橫跨 33 個國家、190 多家渡輪營運商的港口與航線

⛴️

即時行程

取得含參考價格的即時渡輪行程——單程、來回,或最多 5 段航程的跳島串聯

🛳️

船隻詳細資料

查詢航班的船隻詳細資訊:設施、無障礙服務、載客量、照片,以及可預訂的座位/艙房等級與價格

⚠️

中斷警示

取得希臘及歐洲各地的即時中斷警示,包括取消、船隻更換、港口變更與天氣警報

🔗

訂票轉接

取得 Ferryhopper.com 的直接連結,從所選行程繼續完成訂票流程

🧩

MCP 應用程式

MCP 應用程式(請參閱官方總覽)是指任何能夠使用遠端 MCP 工具的用戶端,部分主機還可在工具結果旁呈現 UI 資源。

使用情境

  • 協助使用者搜尋渡輪航線與每日行程
  • 根據出發港口與日期推薦目的地
  • 為旅遊聊天機器人提供動力,規劃來回、跳島或多段航程
  • 回答關於特定船隻的問題——Wi-Fi、餐廳、寵物、艙房、車輛甲板、輪椅無障礙設施
  • 在旅行前或旅行期間告知使用者目前的中斷狀況,以便即時調整計畫

用戶端整合選項

📱

支援 MCP 的主機可使用我們的工具組,若支援 iframe 式 MCP 應用程式,則可呈現更豐富的互動式旅遊結果。

⌨️

純文字或命令列用戶端使用相同的工具端點,僅忽略 UI 資源,直接使用結構化的 JSON 回應來取得港口、航線與行程資料。

可用工具

所有工具皆為唯讀。位置參數接受人類可讀的名稱(城市或港口名稱),而非港口代碼,因此無需先呼叫 get_ports。

搜尋渡輪行程

主要搜尋工具,也是 Trips Picker UI 背後的引擎。傳入 1–5 段航程的有序串聯:單段為單程搜尋,兩段且第二段為第一段反向者為來回,更長者即為跳島串聯。第一段之後的每一段都必須從前一段的抵達地點出發,並依時間順序排列。每一段的選項會獨立回傳,且每個航段都會回報可用性標記(艙房、車輛、寵物、電子票)。支援 MCP 應用程式的主機會呈現選擇器;對話式主機則使用相同的結構化資料。

  • legs[] 陣列,1–5 個項目
  • legs[].departureLocation 字串
  • legs[].arrivalLocation 字串
  • legs[].departureDate 字串(YYYY-MM-DD) Schema
{
  "name": "search_ferry_trips",
  "description": "Search ferry trips as an ordered chain of 1 to 5 legs (one-way, round trip, or island hopping)",
  "parameters": {
    "legs": [
      {
        "departureLocation": "string",
        "arrivalLocation": "string",
        "departureDate": "string (YYYY-MM-DD)"
      }
    ]
  }
}

行程詳細資料

單一航班的完整詳細資訊,透過 search_ferry_trips(legs[].options[].id)回傳的選項 ID 查詢。回傳出發/抵達時間、港口與營運商、船隻規格、設施與照片,以及可預訂的住宿等級與價格。若船隻沒有詳細規格,vessel.hasDetails 為 false,且規格欄位為 null:表示資料無法取得,並不代表該設施不存在。

  • tripId 字串(來自 search_ferry_trips legs[].options[].id) Schema
{
  "name": "trip_details",
  "description": "Get vessel specs, amenities, photos and accommodation options for a single sailing",
  "parameters": {
    "tripId": "string (from search_ferry_trips legs[].options[].id)"
  }
}

取得港口

查詢渡輪港口、碼頭、海上航運站、港口 ID、代碼與地理位置

  • — 無參數 Schema
{
  "name": "get_ports",
  "description": "Find ferry ports, harbors, maritime terminals, port IDs, codes, and geographic locations"
}

取得直達航線

從指定出發港口查詢所有直達渡輪航線與可抵達的目的地港口,不含中途停留或轉乘

  • portLocation 字串 Schema
{
  "name": "get_direct_connections_for_ports",
  "description": "Find all direct ferry routes and reachable destination ports from a given origin port without layovers or transfers",
  "parameters": {
    "portLocation": "string"
  }
}

取得中斷資訊

查詢指定日期與國家的所有渡輪中斷資訊,包括延誤、天氣警報與罷工

  • country 字串(ISO 3166-1 alpha-2,例如 "GR")
  • tripDate 字串(YYYY-MM-DD) Schema
{
  "name": "get_disruptions",
  "description": "Find all ferry travel disruptions, including delays, weather alerts, and strikes for a given date and country",
  "parameters": {
    "country": "string (ISO 3166-1 alpha-2, e.g. \"GR\")",
    "tripDate": "string (YYYY-MM-DD)"
  }
}

搜尋行程(已棄用)

保留給既有整合使用。建議改用 search_ferry_trips,該工具涵蓋此工具的功能,並額外支援來回與多段搜尋。

  • departureLocation 字串
  • arrivalLocation 字串
  • date 字串(YYYY-MM-DD) Schema
{
  "name": "search_trips",
  "description": "Deprecated: get a list of available one-way ferry trips between two ports on a specific date",
  "parameters": {
    "departureLocation": "string",
    "arrivalLocation": "string",
    "date": "string (YYYY-MM-DD)"
  }
}

UI 資源

除了工具之外,我們也提供 MCP 應用程式小工具。支援 MCP 應用程式的主機會擷取這些資源,在工具回應旁呈現更豐富的 UI:

search-ferry-trips-picker ui://widgets/ferry-trips-picker.html

由 search_ferry_trips 使用;每個航段一行,使用者為每個航段選擇一個選項

範例提示詞

可在任何已連線的助理中嘗試以下範例。

單程「星期六早上有哪些從比雷埃夫斯前往埃伊納島的渡輪?」

單程「幫我找 7 月 11 日從伊比薩前往巴塞隆納的渡輪。」

探索「我想明天去雅典 3 小時內可達的島嶼,並於隔天返回,有哪些選擇?」

來回「規劃一趟從比雷埃夫斯到米科諾斯的來回行程,8 月 3 日出發、8 月 10 日返回。」

跳島「我想在 9 月第一週跳島:比雷埃夫斯 → 帕羅斯 → 納克索斯 → 聖托里尼。」

船隻詳細資料「我選的渡輪有 Wi-Fi 嗎?船上允許寵物嗎?」

中斷資訊「今天希臘有渡輪中斷或取消嗎?」

安裝與設定

MCP 用戶端目錄列出目前支援連接 MCP 伺服器的應用程式與代理程式,因此使用支援 MCP 用戶端的團隊可以最少的設定整合 Ferryhopper。

使用 ChatGPT?新增 Ferryhopper 應用程式

Ferryhopper 可作為 ChatGPT 應用程式使用。一鍵即可新增,無需伺服器 URL。

或手動連接任何 MCP 用戶端:

選擇支援 MCP 的用戶端

應用程式範例:

Gemini CLI ChatGPT ↗ Claude.ai / Claude Desktop

新增 Ferryhopper 伺服器

請參閱其文件,並使用以下 URL 進行連接:

https://mcp.ferryhopper.com/mcp

開始規劃

詢問渡輪航線、時刻表、船隻或中斷資訊——請參閱上方範例提示詞。