Equipa de Agentes MCP para Planeamento de Viagens AI

🌍 MCP Travel Planner Agent Team

Uma sofisticada aplicação de planeamento de viagens baseada em Streamlit que cria itinerários de viagem extremamente detalhados e personalizados utilizando múltiplos servidores MCP e integração com o Google Maps. A aplicação utiliza o Airbnb MCP para dados reais de alojamento e um MCP do Google Maps personalizado para cálculos de distância precisos e serviços de localização.

✨ Funcionalidades

🤖 Planeamento de Viagens com IA

• Itinerários Extremamente Detalhados: Cria cronogramas abrangentes dia a dia com horários específicos, endereços e custos
• Cálculos de Distância: Utiliza o Google Maps MCP para calcular distâncias e tempos de viagem precisos entre todos os locais
• Dados de Alojamento em Tempo Real: Integra-se com o Airbnb MCP para preços e disponibilidade atuais
• Recomendações Personalizadas: Personaliza itinerários com base nas preferências do utilizador e nas limitações orçamentais

🏨 Integração com Airbnb MCP

• Listagens de alojamento reais com preços e disponibilidade atuais
• Detalhes da propriedade incluindo comodidades, avaliações de hóspedes e disponibilidade de reservas
• Recomendações conscientes do orçamento filtradas por localização e preferências
• Informação de reserva direta com tarifas em tempo real

🗺️ Integração com Google Maps MCP

• Cálculos de distância precisos entre todos os locais no itinerário
• Estimativas de tempo de viagem para planeamento de transporte
• Serviços de localização para pontos de interesse e navegação
• Verificação de endereços para todos os locais recomendados
• Otimização de transporte com orientações passo a passo

🔍 Integração com Google Search

• Previsões meteorológicas atuais com recomendações detalhadas de vestuário
• Pesquisa de restaurantes com endereços específicos, faixas de preço e avaliações
• Detalhes de atrações incluindo horários de funcionamento, preços de bilhetes e melhores horários para visita
• Informações locais e culturais
• Dicas práticas de viagem incluindo câmbio de moeda e informações de segurança

📅 Funcionalidades Adicionais

• Exportação de Calendário: Descarrega o teu itinerário como um ficheiro .ics para Google Calendar, Apple Calendar ou Outlook
• Análise de Custos Abrangente: Análise detalhada do orçamento para todos os componentes da viagem
• Planeamento de Tempo de Reserva: Inclui tempo de viagem e atrasos inesperados na programação
• Múltiplas Opções de Alojamento: Fornece 3 opções de alojamento com distâncias do centro da cidade

Configuração

Requisitos

1. Chaves de API (Ambas Necessárias):

• Chave da API OpenAI: Obtém a tua chave de API na OpenAI Platform
• Chave da API Google Maps: Obtém a tua chave de API na Google Cloud Console

2. Python 3.8+: Assegura que tens o Python 3.8 ou superior instalado.

3. Servidores MCP: A aplicação conecta-se automaticamente a:

• Servidor MCP do Airbnb: Fornece listagens reais do Airbnb e dados de preços
• MCP do Google Maps Personalizado: Permite cálculos de distância precisos e serviços de localização

Instalação

1. Clona este repositório:

   git clone https://github.com/Shubhamsaboo/awesome-llm-apps.git
   cd awesome-llm-apps/mcp_ai_agents/ai_travel_planner_mcp_agent_team

Instalação

2. Instala os pacotes Python necessários:

   pip install -r requirements.txt

Executar a Aplicação

1. Inicia a aplicação Streamlit:

   streamlit run app.py

2. Na interface da aplicação:

• Introduz a tua OpenAI API key na barra lateral
• Introduz a tua Google Maps API key na barra lateral
• Especifica o teu destino, duração da viagem, orçamento e preferências
• Clica em "🎯 Gerar Itinerário" para criar o teu plano de viagem detalhado

3. Opcional: Descarrega o teu itinerário como um ficheiro de calendário (.ics) para importação no Google Calendar, Apple Calendar ou Outlook

Resolução de Problemas

Problemas Comuns & Soluções

• "Erro: [mensagem de erro]": Verifica a tua ligação à internet e as API keys
• Confirma que ambas as OpenAI e Google Maps API keys estão introduzidas corretamente
• Tenta novamente dentro de alguns minutos - os servidores MCP podem estar temporariamente indisponíveis

• Informação de distância em falta: Problema de ligação ao Google Maps MCP
• Verifica a validade da tua Google Maps API key
• Assegura que a tua API key tem as permissões necessárias para a Maps API
• Tenta atualizar a página e introduzir as keys novamente

• Tempos de resposta lentos: Os servidores MCP podem demorar a responder
• A aplicação tem um tempo limite de 60 segundos configurado
• Espera que o processo termine - itinerários detalhados demoram tempo a gerar

• Problemas de Rede/Filtro: Algumas redes corporativas podem bloquear ligações MCP
• Tenta a partir de uma rede diferente
• Usa uma VPN se necessário
• A aplicação mostrará erros de ligação se os servidores MCP forem inacessíveis

Problemas com API Key

• OpenAI API Key: Assegura que tens créditos na tua conta OpenAI e que a key é válida
• Google Maps API Key: Confirma que a key tem a Maps API ativada e a faturação configurada corretamente

Estado da Ferramenta

A aplicação mostrar-te-á quais fontes de dados foram utilizadas com sucesso:

• 🏨 "O teu itinerário de viagem está pronto com dados do Airbnb!" = Airbnb MCP ligado com sucesso
• 📝 "Usou conhecimento geral para sugestões de alojamento" = Airbnb MCP falhou, utilizando conhecimento geral como alternativa

A aplicação foi desenhada para funcionar de forma fiável! Mesmo que as ligações MCP falhem, irá gerar itinerários abrangentes utilizando as ferramentas e informações disponíveis.

Estrutura do Projeto

├── app.py              # Main Streamlit application with MCP integration
├── requirements.txt    # Python dependencies
└── README.md          # This documentation

Como Funciona

A Equipa do Agente de Planeamento de Viagens AI utiliza um sofisticado processo em múltiplas etapas para criar itinerários de viagem extremamente detalhados:

🤖 Arquitetura do Agente AI

• Modelo GPT-4o: Potencia o planeamento inteligente de viagens com capacidades avançadas de raciocínio
• Integração Multi-MCP: Combina servidores MCP do Airbnb e Google Maps para dados em tempo real
• Ferramentas de Pesquisa do Google: Fornece informações sobre o clima atual, avaliações e insights locais
• Geração de Respostas Diretas: Cria itinerários completos sem fazer perguntas de esclarecimento