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
開始規劃
詢問渡輪航線、時刻表、船隻或中斷資訊——請參閱上方範例提示詞。