aloha.fyi MCP 서버 🌺

최초의 하와이 관광 전용 MCP 서버입니다. AI 어시스턴트를 위한 하와이 투어, 이벤트 및 딜 정보를 제공합니다.

Claude, ChatGPT 또는 기타 AI에게 "하와이에서 무엇을 하면 좋을까?"라고 물어보면, 이 MCP 서버가 실제 예약 가능한 데이터를 반환합니다:

2,583개의 예약 가능한 체험: Viator, GetYourGuide, Klook, Groupon 제공
579개의 이벤트: 오아후, 마우이, 빅 아일랜드, 카우아이 전역
제휴 추적: 모든 예약 링크에 포함
실제 MCP 프로토콜: Streamable HTTP, 상태 비저장(stateless), 사양 버전 2025-03-26

aloha.fyi 제공 — 하와이 AI 컨시어지.

호스팅 엔드포인트

프로덕션 MCP 서버 (설치 및 설정 불필요):

https://mcp-server-nani-v3-20.up.railway.app/mcp

전송: Streamable HTTP (상태 비저장)
프로토콜 버전: 2025-03-26
인증: 없음 (공개, 읽기 전용)
상태: GET /health
검색: GET /.well-known/mcp/server.json

Claude Desktop에 연결

Claude Desktop 설정(~/Library/Application Support/Claude/claude_desktop_config.json, macOS 기준)에 추가하세요:

{
  "mcpServers": {
    "aloha-fyi-hawaii": {
      "url": "https://mcp-server-nani-v3-20.up.railway.app/mcp"
    }
  }
}

Claude Desktop을 재시작하세요. 도구 선택기에 세 가지 하와이 도구가 나타나야 합니다. 다음을 시도해 보세요:

오아후에서 100달러 미만의 스노클링 투어를 찾아줘

이번 주말 호놀룰루에서 열리는 이벤트는 무엇인가요?

빅 아일랜드에서 가족 모험의 날을 계획해줘 — 가장 저렴한 옵션으로

모든 MCP 호환 클라이언트에 연결

Streamable HTTP MCP를 지원하는 모든 클라이언트는 다음 주소로 직접 연결할 수 있습니다:

https://mcp-server-nani-v3-20.up.railway.app/mcp

API 키, OAuth, 가입 절차가 필요 없습니다.

수동 프로토콜 테스트

curl -X POST https://mcp-server-nani-v3-20.up.railway.app/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

도구

`search_hawaii_tours`

키워드, 섬, 가격 범위별로 2,583개의 예약 가능한 하와이 투어 및 액티비티를 검색합니다. Viator, GetYourGuide, Klook, Groupon의 투어 정보를 제휴 예약 링크와 함께 반환합니다.

매개변수	유형	설명
`query`	string (필수)	예: "snorkeling", "helicopter tour", "family luau"
`island`	`oahu`	`maui`	`big_island`	`kauai`	`any`	기본값 `any`
`max_price_dollars`	number	1인당 최대 가격 (USD)
`source`	`viator`	`gyg`	`klook`	`groupon`	`any`	예약 플랫폼별 필터
`limit`	number	결과 수 (최대 20, 기본값 5)

`get_hawaii_deals`

예산 절약형 딜과 할인을 찾습니다. 그루폰 딜과 최저가순으로 정렬된 옵션을 반환합니다.

매개변수	유형	설명
`activity`	string (필수)	예: "snorkeling", "helicopter", "luau"
`max_price_dollars`	number	기본값 100
`limit`	number	결과 수 (최대 20, 기본값 5)

`search_hawaii_events`

모든 하와이 섬의 예정된 이벤트, 콘서트, 축제 및 나이트라이프를 찾습니다. 70개 이상의 장소에서 제공하는 579개 이상의 이벤트를 매주 업데이트합니다.

매개변수	유형	설명
`query`	string	예: "live music", "luau", "concert"
`island`	`oahu`	`maui`	`big_island`	`kauai`	`any`	기본값 `any`
`days_ahead`	number	검색할 향후 일수 (기본값 7)

직접 실행하기

git clone https://github.com/baphometnxg/aloha-fyi-mcp.git
cd aloha-fyi-mcp
npm install
npx tsc
DATABASE_URL="postgresql://..." PORT=9624 node dist/http.js

요구 사항:

Node.js 20+
DATABASE_URL 환경 변수 (experiences 테이블이 있는 PostgreSQL — schema.sql의 스키마 참조)

개인정보 보호

MCP 서버는 어떠한 개인 식별 정보(PII)도 수집하지 않습니다. 상태 비저장 모드로 세션이나 교차 요청 프로필이 없습니다. 표준 요청 메타데이터는 오용 방지를 위해서만 기록됩니다.

전체 개인정보 보호정책: aloha.fyi/privacy

정보

Michael Crain 제작 — 하와이 거주자, 촬영 감독이자 aloha.fyi의 설립자입니다.

aloha.fyi는 하와이 방문객 산업을 위한 AI 기반 다국어 관광 컨시어지입니다. 컨시어지 에이전트 "Nani"는 5개 국어(영어, 일본어, 한국어, 중국어, 스페인어)를 구사하며 6개 제휴 네트워크에 걸쳐 2,583개의 예약 가능한 체험에 접근할 수 있습니다.

이 MCP 서버는 Model Context Protocol을 사용하는 모든 AI 어시스턴트에게 해당 기능의 일부를 제공합니다.

웹사이트: https://aloha.fyi
문의: alohatours@proton.me
라이선스: MIT

알로하 정신으로 제작되었습니다. AI 기반. 하와이 문화에 뿌리를 두고 있습니다. 🌺

aloha-fyi-hawaii