SoloWay
Búsqueda en vivo de viajes en autobús interurbano por Ucrania y Europa: precios en tiempo real, asientos, transportistas, calendario del día más barato y detalles del viaje. Solo lectura, sin clave API; endpoint alojado en https://mcp.soloway.com.ua/mcp.
Documentación
Servidor MCP de SoloWay
Búsqueda en vivo de viajes en autobús interurbano por Ucrania y Europa como servidor MCP remoto. Solo lectura, sin clave de API, sin autenticación. Impulsado por soloway.com.ua — las reservas se completan allí, no a través de las herramientas.
Punto de conexión remoto: https://mcp.soloway.com.ua/mcp (HTTP transmisible, sin estado)
Herramientas
| Herramienta | Qué hace |
|---|---|
search_trips | Viajes entre dos ciudades en una fecha — precios en vivo, asientos libres, transportistas, duración, transbordos, descuentos para pasajeros y un enlace profundo de reserva. Los nombres de ciudades se resuelven automáticamente (uk/en), con desambiguación cuando coinciden varias ciudades. En un resultado vacío, la herramienta verifica rutas a través de ciudades más grandes dentro de ~60 km de los puntos solicitados y devuelve las confirmadas en nearby_alternatives, cada una con distancias de sustitución y su propio enlace de reserva. |
get_calendar_prices | Precio más barato para cada día de un mes en una ruta — encuentra el día más barato para viajar. |
get_trip_details | Detalles completos de un viaje de los resultados de búsqueda — paradas, descuentos de transportista, información de asientos. |
ping | Comprobación de actividad. |
Todas las herramientas declaran outputSchema, readOnlyHint: true y openWorldHint: false.
Conectar
Funciona con cualquier cliente MCP que hable HTTP transmisible. Instrucciones paso a paso para Claude, ChatGPT y otros: soloway.com.ua/connect.
Claude Code:
claude mcp add --transport http soloway https://mcp.soloway.com.ua/mcp
Autoalojamiento
El servidor es un proxy ligero y amigable con la caché sobre la API pública de SoloWay — la imagen de Docker funciona sin configuración adicional:
docker build -t soloway-mcp .
docker run -p 8088:8088 soloway-mcp
# then point your MCP client at http://localhost:8088/mcp
Configuración
Todos los ajustes son variables de entorno con valores predeterminados razonables — consulta .env.example. Los que te pueden interesar:
| Variable | Predeterminado | Notas |
|---|---|---|
PORT | 8088 | Puerto HTTP |
BACKEND_BASE_URL | https://soloway.com.ua (imagen) | Origen de la API de SoloWay |
EXPECTED_HOST | * (imagen) | CSV de valores Host aceptados para solicitudes sin Origin. * acepta cualquier host y desactiva la protección contra reenlace DNS del SDK — adecuado para ejecuciones locales/sandbox; fija tu nombre de host público en producción (nuestra producción establece mcp.soloway.com.ua). |
ALLOWED_ORIGINS | claude.ai / openai.com / soloway.com.ua | CSV, comodines de sufijo admitidos (https://*.claude.ai) |
DEFAULT_LOCALE | uk | uk o en |
SEARCH_MAX_RESULTS | 40 | Límite de viajes devueltos por búsqueda |
Desarrollo
npm install
npm run dev # tsx watch
npm test # vitest
npm run typecheck
server.json es el manifiesto del registro MCP; eval/evals.xml contiene evaluaciones de respuestas estables en formato mcp-builder.