Ferryhopper MCP Server

페리 노선, 일정 및 예약 연동을 위한 AI 어시스턴트 지원

Ferryhopper MCP Server는 페리 노선, 일정 및 예약 리디렉션을 제공하여 AI 어시스턴트가 유럽과 지중해 전역의 연결편을 탐색하고 사용자가 예약을 완료할 수 있도록 Ferryhopper로 안내할 수 있게 합니다.

주요 기능

🌍

항구 및 연결편

33개국, 190개 이상의 페리 운영사의 항구와 연결편 검색

⛴️

실시간 일정

최대 5개 구간의 편도, 왕복 또는 섬 건너뛰기 체인에 대한 실시간 페리 일정과 예상 요금 제공

🛳️

선박 정보

항해에 대한 선박 세부 정보 조회: 편의 시설, 접근성, 수용 인원, 사진, 예약 가능한 좌석/객실 등급 및 요금

⚠️

운항 중단 알림

그리스 및 유럽 전역의 실시간 운항 중단 알림 제공 — 결항, 선박 변경, 항구 변경, 기상 경보 포함

🔗

예약 연동

선택한 여정에서 예약 흐름을 계속할 수 있도록 Ferryhopper.com으로 연결되는 직접 링크 제공

🧩

MCP 앱

MCP 앱(공식 개요 참조)은 원격 MCP 도구를 사용할 수 있고 일부 호스트에서는 도구 결과와 함께 UI 리소스를 렌더링할 수 있는 모든 클라이언트입니다.

사용 사례

• 페리 노선 및 일일 일정을 검색하는 사용자 지원
• 출발 항구와 날짜를 기반으로 목적지 추천
• 왕복, 섬 건너뛰기 또는 다구간 여정을 계획하는 여행 챗봇 구동
• 특정 선박에 대한 질문에 답변 — 와이파이, 레스토랑, 반려동물, 객실, 차량 갑판, 휠체어 접근성
• 여행 전 또는 여행 중 활성 운항 중단 정보를 사용자에게 알려 실시간으로 계획을 조정할 수 있도록 지원

클라이언트 통합 옵션

📱

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) 스키마

{
  "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에서) 스키마

{
  "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, 코드 및 지리적 위치 찾기

• — 매개변수 없음 스키마

{
  "name": "get_ports",
  "description": "Find ferry ports, harbors, maritime terminals, port IDs, codes, and geographic locations"
}

직접 연결편 조회

주어진 출발 항구에서 경유나 환승 없이 갈 수 있는 모든 직접 페리 노선과 도달 가능한 목적지 항구 찾기

• portLocation 문자열 스키마

{
  "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) 스키마

{
  "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) 스키마

{
  "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월 첫 주에 피레우스 → 파로스 → 낙소스 → 산토리니 섬 건너뛰기를 하고 싶습니다.”

선박 정보“선택한 페리에 와이파이가 있고, 반려동물이 탑승 가능한가요?”

운항 중단“오늘 그리스에 페리 운항 중단이나 결항이 있나요?”

설치 및 설정

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

계획 시작

페리 노선, 일정, 선박 또는 운항 중단에 대해 문의하세요 — 위의 예시 프롬프트를 참조하세요.