MCP-сервер aloha.fyi 🌺

Первый специализированный MCP-сервер для туризма на Гавайях. Гавайские туры, события и выгодные предложения для ИИ-ассистентов.

Когда кто-то спрашивает Claude, ChatGPT или любой другой ИИ: «Что мне делать на Гавайях?», этот MCP-сервер возвращает актуальные данные, доступные для бронирования:

2583 доступных для бронирования впечатления от Viator, GetYourGuide, Klook и Groupon
579 событий на островах Оаху, Мауи, Большой остров и Кауаи
Партнерское отслеживание по каждой ссылке для бронирования
Настоящий протокол MCP — Streamable HTTP, без сохранения состояния, версия спецификации 2025-03-26

Работает на базе aloha.fyi — ИИ-консьержа Гавайев.

Размещенная конечная точка

Продакшн-сервер 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`

Поиск по 2583 доступным для бронирования турам и активностям на Гавайях по ключевому слову, острову и ценовому диапазону. Возвращает туры от Viator, GetYourGuide, Klook и Groupon с партнерскими ссылками для бронирования.

Параметр	Тип	Описание
`query`	строка (обязательно)	например, "снорклинг", "вертолетный тур", "семейный луау"
`island`	`oahu`	`maui`	`big_island`	`kauai`	`any`	По умолчанию `any`
`max_price_dollars`	число	Максимальная цена на человека в USD
`source`	`viator`	`gyg`	`klook`	`groupon`	`any`	Фильтр по платформе бронирования
`limit`	число	Результаты (макс. 20, по умолчанию 5)

`get_hawaii_deals`

Поиск бюджетных предложений и скидок. Возвращает предложения Groupon и недорогие варианты, отсортированные по возрастанию цены.

Параметр	Тип	Описание
`activity`	строка (обязательно)	например, "снорклинг", "вертолет", "луау"
`max_price_dollars`	число	По умолчанию 100
`limit`	число	Результаты (макс. 20, по умолчанию 5)

`search_hawaii_events`

Поиск предстоящих событий, концертов, фестивалей и ночной жизни на всех Гавайских островах. Более 579 событий на 70+ площадках, обновляется еженедельно.

Параметр	Тип	Описание
`query`	строка	например, "живая музыка", "луау", "концерт"
`island`	`oahu`	`maui`	`big_island`	`kauai`	`any`	По умолчанию `any`
`days_ahead`	число	На сколько дней вперед искать (по умолчанию 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 (PostgreSQL с таблицей experiences — схема в schema.sql)

Конфиденциальность

MCP-сервер не собирает персональные данные (PII). Режим без сохранения состояния — нет сессий, нет профилей, перекрестных запросов. Стандартные метаданные запросов регистрируются только для предотвращения злоупотреблений.

Полная политика конфиденциальности: aloha.fyi/privacy

О проекте

Создано Майклом Крейном — жителем Гавайев, кинооператором и основателем aloha.fyi.

aloha.fyi — это многоязычный ИИ-консьерж для туристической индустрии Гавайев. Агент-консьерж «Нани» говорит на 5 языках (английский, японский, корейский, китайский, испанский) и имеет доступ к 2583 доступным для бронирования впечатлениям в 6 партнерских сетях.

Этот MCP-сервер предоставляет часть этих возможностей любому ИИ-ассистенту, который поддерживает протокол Model Context Protocol.

Веб-сайт: https://aloha.fyi
Контакты: alohatours@proton.me
Лицензия: MIT

Создано с алоха. Работает на ИИ. Укоренено в гавайской культуре. 🌺

aloha-fyi-hawaii