visaroute

visaroute

あらゆるパスポートと渡航先の組み合わせについて、政府の公式情報に基づいてビザ情報を確認できます。visaroute は、特定のパスポートを所持する旅行者が渡航先の国でビザを必要とするか、渡航中にどのような入国・トランジット要件が適用されるか、それぞれの要件に関する公式情報がどこにあるかを案内し、さらに詳細な分析へのディープリンクも提供します。

読み取り専用で、個人データは送信されません（送信するのは2つの国名または国コードのみ）。API キーも必要ありません。

法律上または移民に関するアドバイスではありません。結果は、パスポート発行国のすべての国民を対象とした一般的な分析です。渡航前に、必ず航空会社および渡航先の当局に確認してください。

仕組み

• check_visa は転送クライアントです。公開されている EasyOnward のリモート MCP エンドポイント（https://mcp.easyonward.com/mcp）に、ストリーム可能な HTTP 経由で JSON-RPC クライアントとして接続します。initialize、notifications/initialized、tools/call の順に呼び出し、リモートから返されるセッションヘッダーを尊重して、回答をそのまま渡します。リモート URL は EASYONWARD_MCP_URL で上書きできます。この通信方式は再構成したものです。上流プロジェクトにはツールの入力、出力、テキスト形式は記載されていますが、通信プロトコルは記載されていないため、再構築版ではその旨を明示しています。
• country_code は完全にローカルで動作します。埋め込みの ISO 3166-1 alpha-2 リストを使って名前を解決し、ネットワークには一切接続しません。

ツール

• check_visa — 指定したパスポートを所持する旅行者が渡航先の国でビザを必要とするか、またどのような入国・トランジット要件が適用されるかを、政府の公式情報とあわせて確認します。入力項目は passport_country と destination_country で、それぞれ ISO 3166-1 alpha-2 コード（US）または国名（United States）を指定します。回答は人間が読みやすいテキストで返され（MCP 経由では structuredContent にも格納されます）、次の情報が含まれます。
  • verdict — 1行で示す平易な要約（制限あり／条件付き／特段の制限なし）。
  • worst_severity — BLOCK | WARN | INFO | NONE。
  • requirements[] — フラグが付けられた各要件の severity、title、detail。
  • official_sources[] — 重複を除いた政府の公式情報源の URL。
  • deep_link — 詳細な分析を表示する https://easyonward.com/visa/{ORIGIN}-{DEST}。
  • prepare_link — 同じページに ?ref=mcp を付けた URL。
  • disclaimer。
• country_code — 国名（または既存の ISO-2 コード）を、大文字の ISO 3166-1 alpha-2 コードに変換します。例：Kenya → KE。check_visa を呼び出す前の確認に便利です。不明な名前を推測することはなく、visaroute error: unknown country: <input> というエラーになります。

check_visa に { "passport_country": "US", "destination_country": "KE" } を渡すと、次の形式のテキストが返されます。

Travel from United States to Kenya is conditional — see requirements.

Requirements:
  [INFO] US travel advisory: Kenya — Level 2 (Exercise Increased Caution) — …
  [INFO] Be ready to show proof of funds for Kenya (KE) — …
  [WARN] An electronic travel authorization (eta) for Kenya on your United States (US) passport — …

Official government sources:
  - https://www.etakenya.go.ke
  - https://immigration.go.ke
  - https://travel.state.gov/…/kenya-travel-advisory.html
  …

Full details: https://easyonward.com/visa/US-KE

Generic analysis for any United States citizen. Not legal or immigration advice — verify with
your airline and the destination's authorities before travel.

エラーには、この再構築版独自のエラーメッセージが使われ、いずれも visaroute error: から始まります。リモートから 2xx 以外の応答が返された場合は visaroute error: HTTP <status>、リモートに接続できない場合は visaroute error: upstream unreachable、リモートの JSON-RPC エラーまたはツールエラーの場合は visaroute error: <message> となります。

設定

• EASYONWARD_MCP_URL（省略可）— check_visa 用のリモート MCP エンドポイント。既定値は https://mcp.easyonward.com/mcp です。

API キーなどの設定は必要ありません。

CLI

各ツールはサブコマンドとして実行し、1つの JSON 引数文字列を受け取ります。

npx @reneturcios/visaroute check_visa '{"passport_country":"US","destination_country":"KE"}'
npx @reneturcios/visaroute country_code '{"country":"Kenya"}'
npx @reneturcios/visaroute --version

check_visa は人間が読みやすいテキストを出力し、country_code は解決されたコードを出力します。終了コード：成功時は 0、実行時エラー時は 1、使用方法のエラー時は 2。

MCP サーバー

npx -y @reneturcios/visaroute mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "visaroute": {
      "command": "npx",
      "args": ["-y", "@reneturcios/visaroute", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/visaroute
docker run --rm ghcr.io/cloudcorprecords/visaroute country_code '{"country":"Kenya"}'

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios