Travel MCP

# Travel MCP orientado a viajes

Este servidor MCP (Model Context Protocol) actua como copiloto para planificar viajes y excursiones. Expone herramientas con datos geograficos, clima, transporte, divisas y contenidos de apoyo para crear experiencias de viaje personalizadas desde un cliente MCP compatible.

Ideas rapidas de uso

Planear itinerarios con coordenadas, distancias, tiempos de traslado y clima en destino.
Preparar al viajero con datos de calidad del aire, tipo de cambio y noticias locales relevantes.
Producir fichas informativas con resumenes de Wikipedia, imagenes inspiradoras y curiosidades del lugar.
Automatizar workflows para asistentes que deben responder sobre ubicaciones, rutas y condiciones en tiempo real.

Herramientas disponibles

Planificacion y logistica

fetch-coordinates: devuelve latitud y longitud de una ciudad.
geocode: convierte una direccion o punto de interes en coordenadas.
reverse-geocode: transforma coordenadas en una direccion legible.
distance: calcula distancia y tiempo de conduccion entre dos lugares.

Condiciones del destino

fetch-weather: obtiene pronosticos puntuales para unas coordenadas.
air-quality: consulta el indice de calidad del aire de una ciudad.
space-photo: aporta una imagen astronomica diaria para destinos astro-turisticos o contenido inspirador.

Finanzas y preparativos

exchange-rate: convierte montos entre monedas.
crypto-price: referencia precios de criptomonedas.
get-current-time: muestra la hora actual del servidor para sincronizar agendas.

Inspiracion y contexto

wiki-summary: resume articulos de Wikipedia para guias rapidas.
book-search: encuentra libros por titulo o autor relacionados con el destino.
search-news-rss: recupera titulares desde feeds RSS para alertas locales.
random-trivia: genera trivias utiles como rompenieves culturales.
get-dog-image: recurso ligero para mensajes amistosos dentro de un asistente de viajes.
spacex-launches: listado util para experiencias orientadas al turismo espacial.

Otros recursos

fetch-cooking-recipe: comparte recetas locales para sumergir al viajero en la gastronomia.
news-alicante-informacion: muestra titulares recientes de informacion.es (ejemplo de feed regional).

Instalacion

npm install

Ejecucion del inspector MCP

npx -y @modelcontextprotocol/inspector npx -y tsx src/main.ts

Ejecutar el inspector sin autenticacion (solo si confias en el cliente)

En PowerShell:

$env:DANGEROUSLY_OMIT_AUTH="true"
npx -y @modelcontextprotocol/inspector npx -y tsx src/main.ts

En CMD:

set DANGEROUSLY_OMIT_AUTH=true
npx -y @modelcontextprotocol/inspector npx -y tsx src/main.ts

Manejo de errores

Cada herramienta aplica un timeout de 8 segundos con AbortController para las peticiones fetch. Si ocurre un error o se supera el limite, la respuesta mantiene un formato consistente:

{ "error": "mensaje descriptivo" }

Este mensaje indica fallos de red, codigos HTTP (p. ej. HTTP 404) o cancelaciones por timeout.