📝 Resumen de arquitectura y notas del ingeniero: tanayshah.dev/projects/travel-mcp-server/ — por Tanay Shah, ingeniero de IA en NYC.

Servidor MCP de viajes

Un servidor MCP que brinda a los asistentes de IA acceso en tiempo real a datos de vuelos, hoteles y clima.

Por qué construí esto

Quería ver si podía hacer que Claude fuera realmente útil para la planificación de viajes: no solo para charlar sobre viajes, sino para buscar vuelos, comparar precios de hoteles y consultar pronósticos meteorológicos. El Protocolo de Contexto de Modelo (MCP) hace esto posible al permitir que los asistentes de IA llamen a herramientas externas.

La parte difícil no fue la integración con MCP, sino obtener datos de viaje fiables. Google Flights bloquea agresivamente a los scrapers, por lo que los vuelos recurren a datos de muestra. Booking.com es más permisivo, por lo que el scraping de hoteles realmente funciona. El clima utiliza la API gratuita de Open-Meteo, que simplemente funciona.

Related MCP server: ts-travel-mcp-server

Qué hace

Inicio rápido

# Install
pip install -e .
playwright install chromium

# Start MongoDB
docker run -d --name mongodb -p 27017:27017 mongo:latest

# Test it
travel-mcp test weather --city Paris --start 2025-06-15
travel-mcp test hotels --city "New York"
travel-mcp test flights --from JFK --to LAX --date 2025-06-15

Uso con Claude Desktop

Añadir a ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "travel": {
      "command": "travel-mcp",
      "args": ["serve"]
    }
  }
}

Luego pregúntale a Claude cosas como:

• "Búscame hoteles en Tokio por menos de $200/noche"

• "¿Qué tiempo hará en París la próxima semana?"

• "Busca vuelos de JFK a LAX"

Comandos CLI

travel-mcp serve              # Run MCP server
travel-mcp test flights ...   # Test flight search
travel-mcp test hotels ...    # Test hotel search
travel-mcp test weather ...   # Test weather search
travel-mcp cache stats        # View cache statistics
travel-mcp cache clear        # Clear cached data

Arquitectura

Claude Desktop
     ↓ (MCP protocol)
Travel MCP Server
     ↓
┌────────────┬─────────────┬──────────────┐
│  Flights   │   Hotels    │   Weather    │
│ fast-flights│ Playwright  │  Open-Meteo  │
└────────────┴─────────────┴──────────────┘
     ↓              ↓              ↓
         MongoDB (cache layer)

Stack tecnológico

• Python 3.11+ con asyncio

• MCP SDK para la integración con Claude

• Playwright para la automatización del navegador

• MongoDB para almacenamiento en caché con índices TTL

• Typer para CLI

• Loguru para registro de logs

Licencia

MIT