Skip to main content
Glama

Servidor MCP aloha.fyi 🌺

El primer servidor MCP dedicado al turismo en Hawái. Tours, eventos y ofertas de Hawái para asistentes de IA — ahora con soporte para respuestas estructuradas AAAK, para que los agentes de consumo puedan analizar los resultados sin tener que volver a procesar el texto.

Cuando alguien le pregunta a Claude, ChatGPT o cualquier IA "¿qué debería hacer en Hawái?", este servidor MCP devuelve datos reales y reservables:

  • 2583 experiencias reservables de Viator, GetYourGuide, Klook y Groupon

  • 579 eventos en Oahu, Maui, la Isla Grande y Kauai

  • Más de 540 restaurantes seleccionados en Waikiki y en todo Oahu

  • Clima en tiempo real para las cuatro islas (OpenMeteo)

  • Itinerarios de planes diarios con opciones para mañana / almuerzo / tarde / cena

  • Seguimiento de afiliados en cada enlace de reserva

  • Protocolo MCP real — HTTP transmitible, sin estado, versión de especificación 2025-03-26

  • AAAK v0.1 — sobre de structuredContent tipado junto con texto legible por humanos. Ver docs/aaak-spec.md.

Desarrollado por aloha.fyi — el conserje de IA de Hawái.

Nota sobre la fuente canónica. Este repositorio es el espejo público del directorio mcp-server de producción dentro de baphometnxg/Nani-V3. Las implementaciones de producción se gestionan desde allí; este repositorio se mantiene sincronizado como una referencia independiente para uso de la comunidad y para cualquiera que desee alojarlo por su cuenta. Reporta problemas aquí o en el repositorio original; ambos funcionan.


Punto final alojado

Servidor MCP de producción (sin instalación, sin configuración):

https://mcp-server-nani-v3-20.up.railway.app/mcp
  • Transporte: HTTP transmitible (sin estado)

  • Versión del protocolo: 2025-03-26

  • Autenticación: ninguna (pública, solo lectura)

  • Salud: GET /health — devuelve aaak: { protocol, enabled, allowlist_size } para que el estado de la implementación sea observable

  • Descubrimiento: GET /.well-known/mcp/server.json


Related MCP server: Famxplor Family Travel Activities

AAAK — contrato de respuesta estructurada

Por defecto, los resultados de las herramientas MCP se devuelven como un bloque de prosa; los agentes que desean consumir los datos mediante programación tienen que volver a analizar el markdown para recuperar precios, URLs de reserva, islas, etc. AAAK soluciona esto.

Cuando AAAK está habilitado (y el cliente que realiza la llamada está en la lista de permitidos), cada resultado de herramienta incluye un campo structuredContent tipado que contiene los datos en una forma legible por máquina, y el tráiler de marketing se elimina del text para ahorrar tokens. Cuando AAAK está desactivado, el formato de transmisión es equivalente en bytes a la v1.0.0 — sin sorpresas para los clientes que no optan por usarlo.

Invariantes sin pérdida — preservadas en cada fila que genera ingresos:

  • booking_url (ingresos de afiliados)

  • source (cumplimiento + atribución)

  • price_cents (el único campo numérico del que dependen las decisiones del usuario)

  • island (cada recomendación está limitada a una isla)

Ejemplo (search_hawaii_tours):

{
  "ok": true,
  "kind": "result",
  "tool": "search_hawaii_tours",
  "protocol": "aaak/0.1",
  "query": { "query": "snorkeling", "island": "oahu", "limit": 1 },
  "results": [
    {
      "title": "Hanauma Bay Snorkel",
      "source": "viator",
      "island": "oahu",
      "area": "east_oahu",
      "category": "tour",
      "price_cents": 8900,
      "rating": 4.7,
      "review_count": 2341,
      "description": "Guided snorkeling at Oahu's most famous reef...",
      "booking_url": "https://aloha.fyi/r/aB3kT9pQz1",
      "is_deal": false
    }
  ],
  "meta": { "count": 1, "cached": false, "source_diversity": 1 }
}

Especificación completa: docs/aaak-spec.md. Esquema JSON generado: docs/aaak.schema.json.

Scripts de verificación para quienes alojan el servidor por su cuenta y colaboradores:

npm run aaak:test    # 12 hand-written conformance fixtures
npm run aaak:smoke   # 9 adapter-output validations
npm run aaak:gate    # ~70 env-gate / trailer / allowlist invariants
npm run aaak:verify -- --expect=aaak --ua=claude-code/1.0   # live probe

Conectar a Claude Desktop

Añadir a la configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

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

Reinicia Claude Desktop. Deberías ver las tres herramientas de Hawái aparecer en el selector de herramientas. Prueba:

Búscame tours de snorkel en Oahu por menos de $100

¿Qué eventos hay en Honolulu este fin de semana?

Planifica un día de aventura familiar en la Isla Grande — opciones más baratas


Conectar a cualquier cliente compatible con MCP

Cualquier cliente que admita MCP HTTP transmitible puede apuntar directamente a:

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

Sin clave de API, sin OAuth, sin registro.

Prueba manual del protocolo

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"}}}'

Herramientas

search_hawaii_tours

Busca entre 2583 tours y actividades reservables en Hawái por palabra clave, isla o rango de precios. Devuelve tours de Viator, GetYourGuide, Klook y Groupon con enlaces de reserva de afiliados.

Parámetro

Tipo

Descripción

query

string (requerido)

ej. "snorkel", "tour en helicóptero", "luau familiar"

island

oahu

maui

big_island

kauai

any

Por defecto any

max_price_dollars

number

Precio máximo por persona en USD

source

viator

gyg

klook

groupon

any

Filtrar por plataforma de reserva

limit

number

Resultados (máx 20, por defecto 5)

get_hawaii_deals

Encuentra ofertas económicas y descuentos. Devuelve ofertas de Groupon y opciones de bajo precio ordenadas de menor a mayor.

Parámetro

Tipo

Descripción

activity

string (requerido)

ej. "snorkel", "helicóptero", "luau"

max_price_dollars

number

Por defecto 100

limit

number

Resultados (máx 20, por defecto 5)

search_hawaii_events

Encuentra próximos eventos, conciertos, festivales y vida nocturna en todas las islas hawaianas. Más de 579 eventos de más de 70 lugares, actualizados semanalmente.

Parámetro

Tipo

Descripción

query

string

ej. "música en vivo", "luau", "concierto"

island

oahu

maui

big_island

kauai

any

Por defecto any

days_ahead

number

Cuántos días de antelación buscar (por defecto 7)


Ejecútalo tú mismo

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

Requiere:

  • Node.js 20+

  • Variable de entorno DATABASE_URL (PostgreSQL con una tabla experiences — esquema en schema.sql)


Privacidad

El servidor MCP no recopila PII (información de identificación personal). Modo sin estado: sin sesiones, sin perfiles entre solicitudes. Los metadatos de solicitud estándar se registran solo para la prevención de abusos.

Política de privacidad completa: aloha.fyi/privacy


Acerca de

Creado por Michael Crain — residente de Hawái, director de fotografía y fundador de aloha.fyi.

aloha.fyi es un conserje turístico multilingüe impulsado por IA para la industria de visitantes de Hawái. El agente conserje "Nani" habla 5 idiomas (inglés, japonés, coreano, chino, español) y tiene acceso a 2583 experiencias reservables en 6 redes de afiliados.

Este servidor MCP expone una parte de esa capacidad a cualquier asistente de IA que hable el Protocolo de Contexto de Modelo (MCP).


Creado con aloha. Impulsado por IA. Arraigado en la cultura hawaiana. 🌺

Available Tools

4 tools
get_hawaii_dealsCInspect

Find the best budget deals and discounts for Hawaii tours and activities. Includes Groupon deals, sales, and value options.

Inputs: activity (required), max_price_dollars, limit.

plan_hawaii_dayAInspect

Get a suggested full-day itinerary for a Hawaiian island or area. Includes morning, afternoon, and evening activities with booking links.

Inputs: island (required), vibe, area.

search_hawaii_eventsBInspect

Find upcoming events, concerts, festivals, and nightlife across all Hawaiian islands. Covers 579+ events from 70+ venues.

Inputs: query, island, days_ahead.

search_hawaii_toursBInspect

Search Hawaii tours and activities by keyword, island, price range, and category. Returns bookable experiences with pricing and affiliate links.

Inputs: query (required), island, max_price_dollars, category, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: get_hawaii_deals focuses on budget deals and discounts, plan_hawaii_day provides full-day itineraries, search_hawaii_events finds events and nightlife, and search_hawaii_tours searches for tours and activities. There is no overlap or ambiguity between these functions.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with 'hawaii' as a common domain identifier: get_hawaii_deals, plan_hawaii_day, search_hawaii_events, and search_hawaii_tours. The naming is predictable and uniform throughout.

    Tool Count4/5

    With 4 tools, the count is reasonable for a Hawaii travel planning server, covering key areas like deals, itineraries, events, and tours. It is slightly on the lower side but well-scoped for its purpose, with each tool earning its place.

    Completeness4/5

    The tool set covers core travel planning functions: finding deals, planning days, searching events, and searching tours. Minor gaps might include tools for accommodations or transportation, but agents can likely work around these with the provided tools for a comprehensive Hawaii trip experience.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers