# Equipa de Agentes MCP para Planeamento de Viagens AI

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

- Fonte: https://doutorai.pt/apps/ai-travel-planner-mcp-agent-team
- Categoria: Agentes MCP
- Dificuldade: Avançado
- Modelos: OpenAI
- Frameworks: Agno
- Corre local?: Precisa de APIs cloud
- Chaves necessárias: GOOGLE_MAPS_API_KEY
- Licença: Apache-2.0
- Site: Doutor AI (https://doutorai.pt) - ferramentas de IA para pequenos negócios em português

## Tutorial completo

## 🌍 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](https://platform.openai.com/api-keys)
    - **Chave da API Google Maps**: Obtém a tua chave de API na [Google Cloud Console](https://console.cloud.google.com/apis/credentials)

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:

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

```markdown
# Instalação

2. Instala os pacotes Python necessários:
```

```bash
   pip install -r requirements.txt
   ```

### Executar a Aplicação

1. Inicia a aplicação Streamlit:

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

## Poupe horas todas as semanas com IA, sem complicações

O **Doutor AI** dá-lhe 1859 prompts de IA prontos a copiar, por indústria e em português simples - mais uma biblioteca técnica completa para quem quer ir mais longe. [Ver planos →](https://doutorai.pt/precos)

---
Conteúdo de Doutor AI (https://doutorai.pt). Ao citar, indique a fonte: https://doutorai.pt/apps/ai-travel-planner-mcp-agent-team