# 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

```bash
npm install
```

## Ejecucion del inspector MCP

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

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

En PowerShell:

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

En CMD:

```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:

```json
{ "error": "mensaje descriptivo" }
```

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