visaroute

visaroute

为任意护照与目的地组合提供签证信息， 并以政府官方来源为依据。visaroute 会告知持有指定护照的旅行者前往目的地国家 是否需要签证、途中适用哪些入境 和过境要求，以及每项要求的官方依据在哪里 — 还会提供指向完整分析的深层链接。

它是只读的，不会发送任何个人数据（只发送两个 国家名称或代码），也不需要 API 密钥。

本内容不构成法律或移民建议。结果是针对护照 所属国家任何公民的一般性分析。出行前，请务必 向航空公司和目的地主管部门核实。

工作原理

• check_visa 是一个转发客户端：它会通过流式 HTTP，以 JSON-RPC 客户端的方式调用已发布的 EasyOnward 远程 MCP 端点 （https://mcp.easyonward.com/mcp）——先执行 initialize，然后执行 notifications/initialized，再执行 tools/call， 并遵循远程服务返回的会话标头 — 随后传递答案。可通过 EASYONWARD_MCP_URL 覆盖远程 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 — 一行通俗易懂的摘要 （受限 / 有条件 / 顺畅）。
  • 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 标签。
  • 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

每个工具都是一个子命令，接收一个 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 — 版权所有 (c) 2026 Rene Turcios