Ferryhopper MCP Server

面向 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

开始规划

询问渡轮航线、时刻表、船舶或中断信息——参见上方示例提示词。