Travel Planner

Um servidor para planejamento de viagens e interação com os serviços do Google Maps.

Documentação

Travel Planner MCP Server (@gongrzhe/server-travelplanner-mcp)

Uma implementação de servidor Model Context Protocol (MCP) do Travel Planner para interagir com o Google Maps e serviços de planejamento de viagens. Este servidor permite que LLMs executem tarefas relacionadas a viagens, como busca de locais, consulta de detalhes de lugares e cálculos de tempo de viagem.

Instalação e Uso

Instalando via Smithery

Para instalar o Travel Planner para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @GongRzhe/TRAVEL-PLANNER-MCP-Server --client claude

Instalando Manualmente

# Using npx (recommended)
npx @gongrzhe/server-travelplanner-mcp

# With environment variable for Google Maps API
GOOGLE_MAPS_API_KEY=your_api_key npx @gongrzhe/server-travelplanner-mcp

Ou instale globalmente:

# Install globally
npm install -g @gongrzhe/server-travelplanner-mcp

# Run after global installation
GOOGLE_MAPS_API_KEY=your_api_key @gongrzhe/server-travelplanner-mcp

Componentes

Ferramentas

searchPlaces
- Busca por lugares usando a API Google Places
- Entrada:
  - query (string): Consulta de busca por lugares
  - location (opcional): Latitude e longitude para enviesar os resultados
  - radius (opcional): Raio de busca em metros
getPlaceDetails
- Obtém informações detalhadas sobre um lugar específico
- Entrada:
  - placeId (string): ID do Google Place para obter detalhes
calculateRoute
- Calcula a rota entre dois locais
- Entrada:
  - origin (string): Local de partida
  - destination (string): Local de chegada
  - mode (opcional): Modo de viagem (dirigindo, a pé, de bicicleta, transporte público)
getTimeZone
- Obtém informações de fuso horário para um local
- Entrada:
  - location: Coordenadas de latitude e longitude
  - timestamp (opcional): Carimbo de data/hora para cálculo do fuso horário

Configuração

Uso com Claude Desktop

Para usar este servidor com o aplicativo Claude Desktop, adicione a seguinte configuração à seção "mcpServers" do seu claude_desktop_config.json:

{
  "mcpServers": {
    "travel-planner": {
      "command": "npx",
      "args": ["@gongrzhe/server-travelplanner-mcp"],
      "env": {
        "GOOGLE_MAPS_API_KEY": "your_google_maps_api_key"
      }
    }
  }
}

Alternativamente, você pode usar o comando node diretamente se tiver o pacote instalado:

{
  "mcpServers": {
    "travel-planner": {
      "command": "node",
      "args": ["path/to/dist/index.js"],
      "env": {
        "GOOGLE_MAPS_API_KEY": "your_google_maps_api_key"
      }
    }
  }
}

Desenvolvimento

Compilando a partir do Código-Fonte

Clone o repositório
Instale as dependências:
```
npm install
```
Compile o projeto:
```
npm run build
```

Variáveis de Ambiente

GOOGLE_MAPS_API_KEY (obrigatório): Sua chave da API Google Maps com as seguintes APIs habilitadas:
- Places API
- Directions API
- Geocoding API
- Time Zone API

Licença

Este servidor MCP é licenciado sob a Licença MIT. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.