SoloWay — Bus Tickets for Ukraine & Europe

SoloWay MCP サーバー

ウクライナとヨーロッパの都市間バス旅行をリアルタイムで検索できる、リモート MCP サーバーです。読み取り専用で、API キーも認証も不要です。soloway.com.ua を利用しており、予約はツール経由ではなく、同サイトで完了します。

リモートエンドポイント： https://mcp.soloway.com.ua/mcp（ストリーミング可能な HTTP、ステートレス）

ツール

ツール	機能
search_trips	指定した日付の2都市間の旅行を検索します。リアルタイムの料金、空席数、運行会社、所要時間、乗り換え、乗客割引、予約へのディープリンクを確認できます。都市名は自動的に解決され（uk/en）、一致する都市が複数ある場合は選択肢を提示します。検索結果が空の場合、指定した出発地と目的地から約60 km圏内の大きな都市を経由するルートを確認し、確認済みのルートを nearby_alternatives で返します。それぞれに代替地までの距離と専用の予約リンクが含まれます。
get_calendar_prices	ルートの月ごとの日別最安料金を確認できます。最も安く旅行できる日を探せます。
get_trip_details	検索結果にある旅行1件の詳細（停留所、運行会社の割引、座席情報）を取得します。
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（イメージ）	SoloWay API のオリジン
EXPECTED_HOST	*（イメージ）	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