Travel Assistant

Um conjunto de servidores MCP para planejamento inteligente de viagens, incluindo voos, hotéis, eventos, geocodificação, clima e finanças.

GitHub

Experimente este MCPPatrocinado

Documentação

🌍 Ecossistema de Servidores MCP Travel Assistant

Um conjunto abrangente de servidores Model Context Protocol (MCP) que trabalham juntos para fornecer planejamento e assistência inteligente de viagens. Este ecossistema permite que o Claude orquestre múltiplos serviços especializados para criar itinerários de viagem detalhados, encontrar voos e acomodações ideais, descobrir eventos locais, analisar condições climáticas e gerenciar considerações de orçamento em diferentes moedas.

🎯 Visão Geral do Sistema

O Ecossistema MCP Travel Assistant consiste em seis servidores especializados que trabalham em harmonia:

🛫 Servidor de Busca de Voos - Encontre e compare voos, analise preços, filtre por preferências
🏨 Servidor de Busca de Hotéis - Descubra acomodações, compare comodidades, filtre por orçamento e preferências
🎭 Servidor de Busca de Eventos - Encontre eventos locais, festivais e atividades
🗺️ Servidor de Geocodificação - Converta locais em coordenadas, calcule distâncias, geocodificação reversa
🌤️ Servidor de Busca de Clima - Obtenha previsões, condições atuais, alertas meteorológicos
💰 Servidor de Busca Financeira - Conversão de moedas, taxas de câmbio, análise financeira

🚀 Exemplo do Mundo Real: Orquestrando um Plano de Viagem Abrangente usando um LLM

Solicitação do Usuário: "Estou planejando uma viagem para Banff e Jasper em Alberta, saindo de Reston, Virgínia, de 7 a 14 de junho de 2025. Encontre voos, hotéis e eventos que estão acontecendo em Banff, Alberta, e coisas para fazer para mim e minha esposa durante o período, com base nas condições climáticas. Gostamos de fazer trilhas, passeios turísticos, jantar e visitar museus. Meu orçamento é de US$ 5.000. Certifique-se de converter os custos de dólares canadenses para USD antes de apresentar."

🎼 Sequência de Resposta Orquestrada

Veja como o Claude orquestra os servidores MCP para atender a esta solicitação complexa:

Etapa 1: Inteligência de Localização 🗺️

Use o Servidor de Geocodificação para converter "Reston, Virgínia", "Banff, Alberta" e "Jasper, Alberta" em coordenadas de latitude/longitude.
Calcule distâncias entre locais para o planejamento do itinerário.

Etapa 2: Descoberta de Voos ✈️

Use o Servidor de Voos para buscar voos do aeroporto mais próximo de Reston, VA (ex.: IAD) para Calgary, AB (mais próximo de Banff/Jasper) para as datas especificadas.
Filtre por preço, duração e companhias aéreas preferidas.
Obtenha informações detalhadas do voo, incluindo escalas, políticas de bagagem e custo total.

Etapa 3: Busca de Acomodações 🏨

Use o Servidor de Hotéis para encontrar hotéis ou aluguéis de temporada em Banff e Jasper para as datas da viagem.
Filtre por preço, comodidades (ex.: WiFi gratuito, café da manhã) e avaliações dos hóspedes.
Obtenha informações detalhadas das propriedades, compare as melhores opções e analise o custo total da acomodação.

Etapa 4: Análise do Clima 🌤️

Use o Servidor de Clima para obter previsões diárias/horárias para Banff e Jasper.
Avalie a adequação do clima para atividades ao ar livre e sugira os melhores dias para trilhas ou passeios turísticos.

Etapa 5: Descoberta de Eventos e Atividades 🎭

Use o Servidor de Eventos para encontrar eventos locais, festivais e atividades em Banff e Jasper durante a viagem.
Filtre por interesses (trilhas, passeios turísticos, restaurantes, museus).

Etapa 6: Análise Financeira 💰

Use o Servidor Financeiro para converter todos os custos (hotéis, eventos, etc.) de CAD para USD.
Garanta que o plano total se encaixe no orçamento de US$ 5.000.

Etapa 7: Síntese Inteligente 🧠

O Claude sintetiza todos os dados para criar:

Opções de voo otimizadas com comparações de preços
Recomendações de hotéis selecionadas que correspondem às preferências e ao orçamento
Agendamento de atividades adequado ao clima
Itinerário dia a dia com opções alternativas para o clima
Detalhamento completo do orçamento em USD com conversão de moeda
Cálculos de distância e tempo de viagem entre locais
Apresenta um itinerário dia a dia, recomenda atividades com base no clima e nos interesses, e fornece um detalhamento do orçamento em USD.

🎯 Por que o MCP Torna Isso Possível

Integração Entre Servidores

Protocolo Unificado: Todos os servidores usam a mesma especificação MCP, permitindo comunicação perfeita
Formatos de Dados Padronizados: Estruturas JSON consistentes em diferentes domínios
Contexto Compartilhado: O Claude mantém o estado da conversa em múltiplas interações com servidores

Sequenciamento Inteligente

Gerenciamento de Dependências: O Claude entende que a geocodificação deve ocorrer antes das previsões meteorológicas
Lógica Condicional: As buscas de voos acionam buscas de hotéis nas cidades de destino
Tratamento de Erros: Se um servidor falhar, o Claude pode adaptar a sequência dinamicamente

Processamento em Tempo Real

Execução Paralela: Múltiplos servidores podem ser consultados simultaneamente quando as dependências permitirem
Dados ao Vivo: Todos os servidores fornecem informações em tempo real (voos, clima, eventos, taxas de câmbio)
Filtragem Dinâmica: Os resultados de um servidor informam os parâmetros de outro

Síntese de Dados

Análise Multi-Domínio: Combina dados meteorológicos com agendamento de eventos e recomendações de atividades
Otimização de Orçamento: A conversão de moedas permite um acompanhamento preciso do orçamento em viagens internacionais
Correspondência de Preferências: Filtra atividades com base nos interesses declarados (trilhas, museus, restaurantes)

Capacidades dos Servidores em Resumo

Servidor	Principais Ferramentas/Recursos/Prompts	Exemplos de Casos de Uso
Flight	`search_flights`, `get_flight_details`, `filter_flights_by_price`	Encontrar e comparar voos, analisar opções
Hotel	`search_hotels`, `get_hotel_details`, `filter_hotels_by_price`	Encontrar hotéis/aluguéis, filtrar por comodidades, comparar
Event	`search_events`, `get_event_details`, `filter_events_by_date`	Descobrir eventos locais, filtrar por tipo/data
Weather	`get_weather_forecast`, `get_current_conditions`, `filter_forecast_by_conditions`	Planejar atividades com base no clima, obter alertas
Geocoder	`geocode_location`, `reverse_geocode`, `calculate_distance`	Converter endereços, planejar rotas, calcular distâncias
Finance	`convert_currency`, `lookup_stock`, `get_market_overview`	Converter custos, analisar orçamento, obter dados de mercado

🛠️ Guia Completo de Instalação

Pré-requisitos

Python 3.8 ou superior
Gerenciador de pacotes UV
Aplicativo Claude Desktop
Chaves de API para os serviços necessários

Chaves de API Necessárias

Chave SerpAPI (para voos, hotéis, eventos) - Obtenha uma chave gratuita
OpenWeatherMap ou use o National Weather Service (gratuito)
OpenStreetMap Nominatim (gratuito, sem necessidade de chave)

Configuração Passo a Passo

Crie o diretório do projeto:

mkdir travel-assistant-mcp
cd travel-assistant-mcp

Clone todos os repositórios dos servidores:

# Create subdirectories for each server
mkdir flight-search hotel-search event-search geocoder weather-search finance-search

Instale as dependências de cada servidor:

# In each server directory
uv sync

Configure o Claude Desktop:

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "flight-search": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/travel-assistant-mcp/flight-search",
        "run", "python", "flight_search_server.py"
      ],
      "env": {
        "SERPAPI_KEY": "your_serpapi_key"
      }
    },
    "hotel-search": {
      "command": "uv", 
      "args": [
        "--directory", "/path/to/travel-assistant-mcp/hotel-search",
        "run", "python", "hotel_search_server.py"
      ],
      "env": {
        "SERPAPI_KEY": "your_serpapi_key"
      }
    },
    "event-search": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/travel-assistant-mcp/event-search", 
        "run", "python", "event_search_server.py"
      ],
      "env": {
        "SERPAPI_KEY": "your_serpapi_key"
      }
    },
    "geocoder": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/travel-assistant-mcp/geocoder",
        "run", "python", "geocoder_server.py" 
      ]
    },
    "weather-search": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/travel-assistant-mcp/weather-search",
        "run", "python", "weather_search_server.py"
      ]
    },
    "finance-search": {
      "command": "uv", 
      "args": [
        "--directory", "/path/to/travel-assistant-mcp/finance-search",
        "run", "python", "finance_search_server.py"
      ],
      "env": {
        "SERPAPI_KEY": "your_serpapi_key"
      }
    }
  }
}

Reinicie o Claude Desktop para carregar todos os servidores.

💡 Exemplos de Uso Avançado

Planejamento de Fim de Semana

Plan a weekend trip from San Francisco to Portland, Oregon for next weekend. 
We want to visit breweries, food trucks, and outdoor markets. Budget is $1500 
for 2 people. Find flights leaving Friday evening and returning Sunday night.

Viagem de Negócios Internacional

I need to travel from New York to Tokyo for a conference June 20-25, 2025. 
Find business class flights, luxury hotels near Tokyo Station, check weather 
for appropriate clothing, and convert all costs to USD. Also find networking 
events for tech professionals during that week.

Planejamento de Férias em Família

Plan a family vacation to Orlando, Florida for July 15-22, 2025 for 2 adults 
and 2 children (ages 8 and 12). We want to visit theme parks, but also need 
backup indoor activities in case of rain. Budget is $8000 USD total.

Tour Europeu Multi-Cidades

Plan a 2-week European tour visiting London, Paris, Rome, and Barcelona 
from August 5-19, 2025. Find the most efficient flight routing, centrally 
located hotels, cultural events and museums, check weather patterns, 
and provide a day-by-day itinerary with budget breakdown.

🏗️ Benefícios da Arquitetura

Modularidade

Cada servidor lida com um domínio específico com excelência
Os servidores podem ser atualizados de forma independente
Fácil adicionar novas capacidades (aluguel de carros, reservas de restaurantes, etc.)

Escalabilidade

Os servidores podem ser distribuídos em diferentes sistemas
Balanceamento de carga possível para cenários de alto tráfego
Falhas individuais de servidores não derrubam todo o sistema

Privacidade de Dados

Sem necessidade de armazenamento central de dados
Cada servidor gerencia suas próprias políticas de retenção de dados
Os usuários controlam quais servidores ativar

Extensibilidade

Novos servidores relacionados a viagens podem ser adicionados facilmente
Lógica de negócios personalizada pode ser implementada por servidor
Integração com sistemas empresariais de gerenciamento de viagens possível

🔧 Guia de Solução de Problemas

Problemas Comuns de Integração

Servidores não se comunicando:

Verifique se todos os servidores estão em execução: ps aux | grep python
Verifique os caminhos de configuração do Claude Desktop
Garanta que todas as chaves de API sejam válidas e tenham cota suficiente

Resultados inconsistentes:

Algumas APIs têm limites de taxa - espaçe as solicitações
As taxas de câmbio e os preços de voos mudam com frequência
As previsões meteorológicas tornam-se menos precisas além de 7 dias

Cálculos de orçamento incorretos:

Sempre use as taxas de câmbio mais recentes do servidor financeiro
Considere taxas de reserva e impostos nos preços de hotéis/voos
Considere variações sazonais de preços

Otimização de Desempenho

Cache: A maioria dos servidores armazena resultados em cache localmente para reduzir chamadas de API
Processamento Paralelo: O Claude pode consultar múltiplos servidores simultaneamente
Filtragem Inteligente: Use buscas amplas primeiro, depois refine com filtros

🤝 Contribuindo

Este ecossistema prospera com contribuições da comunidade:

Novos Tipos de Servidores: Reservas de restaurantes, aluguel de carros, seguro de viagem
Filtragem Aprimorada: Correspondência de preferências mais sofisticada
Melhor Integração: Compartilhamento de dados e cache entre servidores
Suporte Móvel: Estender o suporte MCP para aplicativos de viagem móveis

📄 Licença

Este ecossistema de assistente de viagens é open source sob a Licença MIT. Servidores individuais podem ter licenças diferentes - verifique a documentação de cada servidor.

🆘 Suporte

Para problemas relacionados a:

Servidores Individuais: Verifique o README e o repositório do servidor específico
Problemas de Integração: Crie uma issue no repositório principal travel-assistant-mcp
Claude Desktop: Visite a documentação de suporte da Anthropic
Problemas de API: Entre em contato com os respectivos provedores de API (SerpAPI, serviços meteorológicos, etc.)

O poder do MCP reside na sua capacidade de orquestrar fluxos de trabalho complexos e de múltiplas etapas que tradicionalmente exigiriam múltiplos aplicativos e coordenação manual. Com este ecossistema de assistente de viagens, o Claude se torna seu agente de viagens inteligente, capaz de lidar com solicitações sofisticadas que abrangem múltiplos domínios e fontes de dados.