Travel Planner

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

Una implementación de servidor Travel Planner Model Context Protocol (MCP) para interactuar con Google Maps y servicios de planificación de viajes. Este servidor permite a los LLMs realizar tareas relacionadas con viajes, como búsqueda de ubicaciones, consulta de detalles de lugares y cálculos de tiempo de viaje.

Instalación y Uso

Instalación mediante Smithery

Para instalar Travel Planner para Claude Desktop automáticamente a través de Smithery:

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

Instalación Manual

# 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

O instalar 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

Herramientas

• searchPlaces

  • Buscar lugares usando la API de Google Places
  • Entrada:
    • query (cadena): Consulta de búsqueda para lugares
    • location (opcional): Latitud y longitud para sesgar los resultados
    • radius (opcional): Radio de búsqueda en metros

• getPlaceDetails

  • Obtener información detallada sobre un lugar específico
  • Entrada:
    • placeId (cadena): ID de lugar de Google para recuperar detalles

• calculateRoute

  • Calcular la ruta entre dos ubicaciones
  • Entrada:
    • origin (cadena): Ubicación de inicio
    • destination (cadena): Ubicación de destino
    • mode (opcional): Modo de viaje (conducción, caminata, bicicleta, transporte público)

• getTimeZone

  • Obtener información de zona horaria para una ubicación
  • Entrada:
    • location: Coordenadas de latitud y longitud
    • timestamp (opcional): Marca de tiempo para el cálculo de la zona horaria

Configuración

Uso con Claude Desktop

Para usar este servidor con la aplicación Claude Desktop, agregue la siguiente configuración a la sección "mcpServers" de su 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, puede usar el comando node directamente si tiene el paquete instalado:

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

Desarrollo

Compilación desde el Código Fuente

1. Clonar el repositorio
2. Instalar dependencias:

   npm install
   

3. Compilar el proyecto:

   npm run build
   

Variables de Entorno

• GOOGLE_MAPS_API_KEY (requerido): Su clave de API de Google Maps con las siguientes APIs habilitadas:
  • API de Places
  • API de Directions
  • API de Geocoding
  • API de Time Zone

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Para más detalles, consulte el archivo LICENSE en el repositorio del proyecto.