SoloWay
Pesquisa ao vivo de viagens de ônibus intermunicipais pela Ucrânia e Europa — preços em tempo real, assentos, transportadoras, calendário de dia mais barato e detalhes da viagem. Somente leitura, sem chave de API; endpoint hospedado em https://mcp.soloway.com.ua/mcp.
Documentação
SoloWay MCP Server
Pesquisa ao vivo de viagens de ônibus intermunicipais pela Ucrânia e Europa como um servidor MCP remoto. Somente leitura, sem chave de API, sem autenticação. Desenvolvido por soloway.com.ua — as reservas são concluídas lá, não por meio das ferramentas.
Endpoint remoto: https://mcp.soloway.com.ua/mcp (HTTP com streaming, sem estado)
Ferramentas
| Ferramenta | O que faz |
|---|---|
search_trips | Viagens entre duas cidades em uma data — preços ao vivo, assentos livres, transportadoras, duração, transferências, descontos para passageiros e um link direto de reserva. Os nomes das cidades são resolvidos automaticamente (uk/en), com desambiguação quando várias cidades correspondem. Em um resultado vazio, a ferramenta verifica rotas por meio de cidades maiores dentro de ~60 km dos endpoints solicitados e retorna as confirmadas em nearby_alternatives, cada uma com distâncias de substituição e seu próprio link de reserva. |
get_calendar_prices | Preço mais barato para cada dia de um mês em uma rota — encontre o dia mais barato para viajar. |
get_trip_details | Detalhes completos de uma viagem dos resultados de pesquisa — paradas, descontos da transportadora, informações sobre assentos. |
ping | Verificação de atividade. |
Todas as ferramentas declaram outputSchema, readOnlyHint: true e openWorldHint: false.
Conectar
Funciona com qualquer cliente MCP que fale HTTP com streaming. Instruções passo a passo para Claude, ChatGPT e outros: soloway.com.ua/connect.
Claude Code:
claude mcp add --transport http soloway https://mcp.soloway.com.ua/mcp
Auto-hospedagem
O servidor é um proxy fino e amigável a cache sobre a API pública do SoloWay — a imagem Docker funciona pronta para uso:
docker build -t soloway-mcp .
docker run -p 8088:8088 soloway-mcp
# then point your MCP client at http://localhost:8088/mcp
Configuração
Todas as configurações são variáveis de ambiente com padrões sensatos — veja .env.example. As que você pode se importar:
| Variável | Padrão | Observações |
|---|---|---|
PORT | 8088 | porta HTTP |
BACKEND_BASE_URL | https://soloway.com.ua (imagem) | origem da API SoloWay |
EXPECTED_HOST | * (imagem) | CSV de valores Host aceitos para solicitações sem Origin. * aceita qualquer host e desativa a proteção contra rebinding de DNS do SDK — adequado para execuções locais/sandbox; fixe seu hostname público em produção (nossa produção define mcp.soloway.com.ua). |
ALLOWED_ORIGINS | claude.ai / openai.com / soloway.com.ua | CSV, curingas de sufixo suportados (https://*.claude.ai) |
DEFAULT_LOCALE | uk | uk ou en |
SEARCH_MAX_RESULTS | 40 | Limite de viagens retornadas por pesquisa |
Desenvolvimento
npm install
npm run dev # tsx watch
npm test # vitest
npm run typecheck
server.json é o manifesto do registro MCP; eval/evals.xml contém avaliações de respostas estáveis no formato mcp-builder.