SoloWay — Bus Tickets for Ukraine & Europe

SoloWay MCP 服务

通过远程 MCP 服务，实时搜索乌克兰和欧洲的城际巴士行程。只读，无需 API 密钥，也无需身份验证。由 soloway.com.ua 提供支持——请在该网站完成预订，而非通过工具预订。

远程端点： https://mcp.soloway.com.ua/mcp（可流式传输的 HTTP，无状态）

工具

工具	功能
search_trips	查询指定日期两个城市之间的行程，返回实时价格、空余座位、承运商、时长、中转信息、乘客折扣和预订直达链接。城市名称会自动解析（uk/en）；如果匹配到多个城市，则会要求消除歧义。如果没有搜索结果，该工具会验证请求出发地和目的地约 60 km 范围内较大城市之间的路线，并在 nearby_alternatives 中返回已确认的路线，每条路线都包含替代地点的距离和专属预订链接。
get_calendar_prices	查询某条路线一个月内每天的最低价格，找出最便宜的出行日期。
get_trip_details	查看搜索结果中某趟行程的完整详情，包括停靠站、承运商折扣和座位信息。
ping	检查服务是否正常运行。

所有工具均声明 outputSchema、readOnlyHint: true 和 openWorldHint: false。

连接

可与任何支持可流式传输 HTTP 的 MCP 客户端配合使用。Claude、ChatGPT 等产品的分步说明：soloway.com.ua/connect。

Claude Code：

claude mcp add --transport http soloway https://mcp.soloway.com.ua/mcp

自托管

该服务是一个基于公开 SoloWay API 的轻量代理，支持缓存——Docker 镜像开箱即用：

docker build -t soloway-mcp .
docker run -p 8088:8088 soloway-mcp
# then point your MCP client at http://localhost:8088/mcp

配置

所有设置均为环境变量，并提供合理的默认值——请参阅 .env.example。以下是你可能需要关注的设置：

变量	默认值	说明
PORT	8088	HTTP 端口
BACKEND_BASE_URL	https://soloway.com.ua (image)	SoloWay API 源站
EXPECTED_HOST	* (image)	对于不带 Origin 的请求，可接受的 Host 值列表，以 CSV 格式填写。* 表示接受任意主机，并禁用 SDK 的 DNS 重绑定防护措施——适用于本地或沙盒运行；生产环境中请固定为你的公开主机名（我们的生产环境设置为 mcp.soloway.com.ua）。
ALLOWED_ORIGINS	claude.ai / openai.com / soloway.com.ua	CSV 格式，支持后缀通配符（https://*.claude.ai）
DEFAULT_LOCALE	uk	uk 或 en
SEARCH_MAX_RESULTS	40	每次搜索返回的行程数量上限

开发

npm install
npm run dev        # tsx watch
npm test           # vitest
npm run typecheck

server.json 是 MCP 注册表清单；eval/evals.xml 以 mcp-builder 格式保存稳定答案评估。

许可证

MIT