MCP Server - Travel

Un MCP Server para búsqueda de vuelos, hoteles, clima y atracciones turísticas.

Características

• ✈️ Búsqueda de Vuelos - Encuentra vuelos de ida y vuelta entre aeropuertos
• 🏨 Búsqueda de Hoteles - Busca alojamientos por ciudad y fechas
• 🌤️ Pronóstico del Clima - Obtén el clima para tu destino
• 🎯 Atracciones Turísticas - Descubre museos, restaurantes y puntos de interés
• 🍽️ Búsqueda de Restaurantes - Encuentra restaurantes por tipo de cocina

Instalación

Requisitos

• Node.js 18 o superior
• npm o yarn
• APIs keys gratuitas (instrucciones abajo)

Pasos

1. Clonar el repositorio

   git clone <repo-url>
   cd mcp-server-travel
   

2. Instalar dependencias

   npm install
   

3. Configurar API Keys

   cp .env.example .env
   

   Luego editar .env con tus API keys:

   # Obtener en: https://openweathermap.org/api
   OPENWEATHER_API_KEY=your_key_here
   
   # Obtener en: https://developers.amadeus.com/
   AMADEUS_API_KEY=your_key_here
   
   # Obtener en: https://www.geoapify.com/
   GEOAPIFY_API_KEY=your_key_here
   

Desarrollo

Ejecutar en modo desarrollo

npm run dev

El servidor se iniciará y mostrará los tools disponibles.

Compilar TypeScript

npm run build

Integración con clientes MCP

Este MCP Server es compatible con cualquier cliente que soporte el protocolo Model Context Protocol.

Configuración del cliente

Consulta la documentación de tu cliente MCP para saber cómo agregar servidores MCP personalizados. Por ejemplo, para Claude Desktop, la configuración se realiza en:

Ejemplo de configuración

Este es un ejemplo de cómo se vería la configuración (varía según el cliente):

{
  "mcpServers": {
    "travel": {
      "command": "node",
      "args": ["/path/to/mcp-server-travel/dist/index.js"],
      "env": {
        "OPENWEATHER_API_KEY": "your_key_here",
        "AMADEUS_API_KEY": "your_key_here",
        "GEOAPIFY_API_KEY": "your_key_here"
      }
    }
  }
}

Configuración

• Reemplaza /path/to/mcp-server-travel con la ruta actual al directorio del proyecto
• Reemplaza los valores de env con tus API keys
• Reinicia tu cliente MCP para que los cambios tomen efecto

Tools Disponibles

✈️ Vuelos

search_flights

Busca vuelos de ida entre dos aeropuertos.

Parámetros:

• origin (string): Código IATA del aeropuerto de origen (ej: "BUE", "JFK")
• destination (string): Código IATA del destino (ej: "FCO", "CDG")
• departure_date (string): Fecha de salida en formato YYYY-MM-DD

Ejemplo:

Buscar vuelos de Buenos Aires a Roma para el 15 de mayo

search_round_trip_flights

Busca vuelos de ida y vuelta.

Parámetros:

• origin (string): Código IATA del origen
• destination (string): Código IATA del destino
• departure_date (string): Fecha de salida (YYYY-MM-DD)
• return_date (string): Fecha de regreso (YYYY-MM-DD)

🏨 Hoteles

search_hotels

Busca hoteles en una ciudad para fechas específicas.

Parámetros:

• city (string): Nombre de la ciudad
• check_in_date (string): Fecha de entrada (YYYY-MM-DD)
• check_out_date (string): Fecha de salida (YYYY-MM-DD)
• adults (number, opcional): Número de adultos (default: 1)

get_hotel_details

Obtiene detalles y precios de un hotel específico.

Parámetros:

• hotel_id (string): ID del hotel
• check_in_date (string): Fecha de entrada (YYYY-MM-DD)
• check_out_date (string): Fecha de salida (YYYY-MM-DD)

🌤️ Clima

get_weather

Obtiene el pronóstico del clima para una ciudad en una fecha específica.

Parámetros:

• city (string): Nombre de la ciudad
• date (string): Fecha (YYYY-MM-DD)

get_weather_forecast

Obtiene el pronóstico extendido (hasta 5 días).

Parámetros:

• city (string): Nombre de la ciudad
• start_date (string): Fecha de inicio (YYYY-MM-DD)
• days (number, opcional): Número de días (default: 5, max: 5)

🎯 Atracciones

search_attractions

Busca atracciones turísticas por categoría.

Parámetros:

• city (string): Nombre de la ciudad
• category (string): Categoría (ej: "tourism", "museum", "park", "historic")

Categorías disponibles: tourism, museum, park, historic, restaurant, landmark

search_attractions_by_categories

Busca atracciones en múltiples categorías a la vez.

Parámetros:

• city (string): Nombre de la ciudad
• categories (array, opcional): Array de categorías

search_restaurants

Busca restaurantes, opcionalmente por tipo de cocina.

Parámetros:

• city (string): Nombre de la ciudad
• cuisine (string, opcional): Tipo de cocina (ej: "Italian", "Japanese")

Códigos IATA Comunes

Aeropuertos Argentina

• BUE: Buenos Aires (Ministro Pistarini)
• ARB: Buenos Aires (Aeroparque)

Aeropuertos Principales

• JFK: Nueva York (John F. Kennedy)
• LAX: Los Ángeles
• ORD: Chicago
• LHR: Londres (Heathrow)
• CDG: París (Charles de Gaulle)
• FCO: Roma (Fiumicino)
• MAD: Madrid
• BCN: Barcelona
• VCE: Venecia
• MIL: Milán

Licencia

MIT

Soporte

Para reportar bugs o sugerencias, abre un issue en el repositorio.