aloha-fyi-hawaii
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-26AAAK v0.1 — sobre de
structuredContenttipado junto con texto legible por humanos. Verdocs/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-serverde producción dentro debaphometnxg/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/mcpTransporte: HTTP transmitible (sin estado)
Versión del protocolo:
2025-03-26Autenticación: ninguna (pública, solo lectura)
Salud: GET /health — devuelve
aaak: { protocol, enabled, allowlist_size }para que el estado de la implementación sea observableDescubrimiento: 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 probeConectar 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/mcpSin 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 | ||||
| string (requerido) | ej. "snorkel", "tour en helicóptero", "luau familiar" | ||||
|
|
|
|
|
| Por defecto |
| number | Precio máximo por persona en USD | ||||
|
|
|
|
|
| Filtrar por plataforma de reserva |
| 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 |
| string (requerido) | ej. "snorkel", "helicóptero", "luau" |
| number | Por defecto 100 |
| 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 | ||||
| string | ej. "música en vivo", "luau", "concierto" | ||||
|
|
|
|
|
| Por defecto |
| 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.jsRequiere:
Node.js 20+
Variable de entorno
DATABASE_URL(PostgreSQL con una tablaexperiences— esquema enschema.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).
Sitio web: https://aloha.fyi
Contacto: alohatours@proton.me
Licencia: MIT
Creado con aloha. Impulsado por IA. Arraigado en la cultura hawaiana. 🌺
Available Tools
4 toolsget_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
Scored across 4 tools
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.
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.
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.
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
Related MCP Connectors
Official MCP server for MAQAMI, a hotel and flight booking platform with 3M+ hotels.
Skiplagged MCP Server for flight search, hotel booking, and travel planning
Official MCP server for MAQAMI, a hotel and flight booking platform with 3M+ hotels. Search live hotel rates and flights, look up places, airports and hotel details, then prebook and book. Remote Streamable HTTP endpoint, no API key required.
Official ConnectMeGuru MCP server: search 190+ travel eSIM data plans and buy in-chat.
Related MCP Servers
- AlicenseBqualityDmaintenanceThis MCP server provides access to TripAdvisor data for planning vacations, enabling users to search for and get details about locations, attractions, restaurants, and hotels through an interactive planning experience.42Apache 2.0
- AlicenseBqualityDmaintenanceThe first MCP server dedicated to families who travel with their kids. Find activities tested by families worldwide11MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for travel program search, comparison, and booking via Yourttoo API, optimized for LLMs with token-saving responses.ISC
- AlicenseAqualityDmaintenanceAn official MCP server for ConnectMeGuru to search active travel eSIM packages, apply discount coupons, check wallet balance, and purchase eSIM plans directly within AI chats.141MIT