Orizn Visa

官方

涵盖39,585组护照与目的地组合的签证要求，支持15种语言。可查询任意国家组合的签证类型、所需文件及旅行建议。

GitHub
1
试用此 MCP赞助

你可以用 Orizn Visa MCP 做什么？

  • 检查签证要求 — 询问“从法国去日本需要签证吗？”并通过 check_visa_requirement 获取完整入境规定，包括所需文件、费用和处理时间。
  • 快速签证状态 — 使用 quick_visa_check 获取关于签证要求和免签天数的单行答案，无需 API 密钥（每天 10 次查询）。
  • 比较目的地 — 使用 compare_destinations 并排比较同一护照可前往的最多 25 个国家，涵盖费用、安全和健康要求。
  • 过境签证规则 — 使用 check_transit_visa 查询中转停留规定，包括是否可离开机场以及主要枢纽的免费过境时长。
  • 覆盖统计 — 询问“覆盖多少个国家？”并通过 get_coverage_stats 获取实时数据库统计，无需密钥。
  • 多语言支持 — 通过指定 lang 参数，以 15 种语言中的任意一种（如法语、西班牙语、日语）获取签证答案。

文档

Orizn Visa API MCP 服务器

Orizn Visa API MCP 服务器是一个模型上下文协议（MCP）服务器，为 AI 助手提供任意护照/目的地组合的签证和入境要求，支持 15 种语言回答。

覆盖范围持续增长：与其在这里印一个会过时的数字，不如让 get_coverage_stats 工具直接从 API 实时读取（该 API 也在 https://visa.orizn.app/api/v1/visa/stats 公开提供）。

npm version License: MIT MCP Compatible

它可以回答诸如“我从法国去日本需要签证吗”、“美国公民去中国需要什么文件”、“持印度护照在伊斯坦布尔中转期间可以离开机场吗”之类的问题——基于数据，而非猜测。

兼容性

该服务器通过 stdio 使用 MCP 协议，运行在 Node.js 18 或更高版本上。它适用于任何能够启动 stdio 服务器的 MCP 客户端，包括 Claude Desktop、Claude Code 和 Cursor。下面的配置块对所有客户端都相同。

安装

npx orizn-visa-mcp

无需构建，无需克隆。将其添加到您的 MCP 客户端配置中：

{
  "mcpServers": {
    "orizn-visa": {
      "command": "npx",
      "args": ["-y", "orizn-visa-mcp"]
    }
  }
}

重启客户端，然后提问：“我从法国去日本需要签证吗？” —— 无需 API 密钥即可使用，每天 10 次检查。

对于其他所有功能（文件、费用、办理时间、中转规则、15 种语言），请添加一个免费密钥：

{
  "mcpServers": {
    "orizn-visa": {
      "command": "npx",
      "args": ["-y", "orizn-visa-mcp"],
      "env": {
        "ORIZN_API_KEY": "orizn_visa_..."
      }
    }
  }
}

密钥也可以作为参数传递，其优先级高于环境变量：

npx orizn-visa-mcp --api-key orizn_visa_...

示例问题

  • “我从法国去泰国旅行需要签证吗？”
  • “作为美国公民访问中国需要什么文件？”
  • “比较一下巴西护照前往泰国、越南和印度尼西亚的情况。”
  • “持中国护照在伊斯坦布尔 12 小时中转期间可以离开机场吗？”
  • “菲律宾护照持有者办理申根签证需要多少钱？”
  • “持法国护照进入巴西需要接种哪些疫苗？”
  • “我的泰国签证逾期 3 天会有什么罚款？”
  • “葡萄牙有数字游民签证吗，费用是多少？”
  • “Réponds en français : ai-je besoin d'un visa pour le Japon avec un passeport marocain ?”

工具

工具参数返回内容套餐
check_visa_requirementpassport, destination, lang一本护照进入一个目的地的完整入境要求：要求类型、允许天数、文件、申请步骤、费用、办理时间、护照有效期、照片规格、疫苗接种、保险、安全建议、逾期罚款、空/陆/海入境、远程工作签证、延期和未成年人规则、大使馆。任意密钥
quick_visa_checkpassport, destination一行内容：要求代码、免签天数以及该组合最后核验的日期。不含文件、费用或翻译。无 — 每天 10 次免密钥，任意密钥不限量
compare_destinationspassport, destinations（1–25）, lang一本护照最多 25 个目的地并排对比：要求、免签天数、描述、护照有效期、费用、安全、健康、疫苗接种、保险、按方式入境、远程工作签证。每个返回的目的地计为一次请求。Hobby 或以上
check_transit_visapassport, transit_country, lang仅中转规则：旅客在转机期间是否可以留在空侧或离开机场，以及主要枢纽提供多少免费中转小时。Hobby 或以上
get_coverage_stats无数据库规模：组合数、护照数、目的地数、翻译数、语言数以及要求类型的分布。不涉及特定组合。无
get_recent_changespassport, destination, since, limit（均可选）近期变更的签证规则，附报告来源和日期。该信息流当前已关闭 — 见下文。无

国家代码使用 ISO 3166-1 alpha-3（FRA, JPN, USA），而非 alpha-2。

requirement 是 visa_free, visa_required, e_visa, visa_on_arrival, eta, no_admission 之一，外加较少见的 partial_restrictions, admission_refused, not_applicable 和 special。

资源

visa://supported-languages — lang 接受的 15 个代码，所有套餐（包括免费）均可用：en fr es pt de ja ko zh ru it ar hi th vi tl。

get_recent_changes 有意返回空内容

Orizn 的政策变更信息流已关闭。它此前将两个内部 Orizn 表之间检测到的不一致当作官方政策变更来提供，因此现在返回 HTTP 503，该工具降级为：

{ "status": "unavailable", "changes": [], "do_not_conclude": "This is NOT evidence that no visa rules changed..." }

该工具以这种状态发布是有意为之：一个空的、标注清晰的回答才是诚实的回答。当信息流基于经过核实的官方来源运行时，该工具将开始返回真实条目——届时，没有具名来源和日期的条目将被扣留而非显示。

身份验证和免费套餐

quick_visa_check, get_coverage_stats 和 get_recent_changes 完全无需 API 密钥即可使用。免密钥的 quick_visa_check 限制为每天 10 次检查——与 visa.orizn.app 给匿名访客的配额相同。超过该限制后，工具会明确说明并指向免费密钥，而不是静默失败。该限制按每个运行中的服务器进程计算，并在 UTC 时间 00:00 重置。

另外三个工具需要 API 密钥，通过 x-api-key 请求头发送至 https://visa.orizn.app/api/v1/visa。

在 visa.orizn.app/visa-api 免费获取一个——无需信用卡。免费套餐为每月 50 次请求（在您确认邮箱地址之前为 5 次），包含核心字段和全部 15 种语言。在免费套餐中，更深层的字段——费用、办理天数、照片规格、疫苗接种、保险、过境签证、按方式入境、逾期罚款、远程工作签证、大使馆——会以 {"upgrade": "..."} 占位符形式返回，且 compare_destinations 和 check_transit_visa 受到限制。

Hobby 套餐每月 9 美元，含 10,000 次请求，解锁全部功能：升级。更高量级的套餐列在定价页面上。

将密钥放在 MCP 配置的 env 块中——MCP 客户端不会继承您的 shell 环境，因此在终端中导出 ORIZN_API_KEY 是不够的。

无需任何 MCP 客户端即可检查密钥：

curl -H "x-api-key: $ORIZN_API_KEY" \
  "https://visa.orizn.app/api/v1/visa/check?passport=FRA&destination=JPN"

{ "passport": "FRA", "destination": "JPN", "requirement": "visa_free", "visa_free_days": 90 }

故障排查

症状解决方法
“未找到 Orizn API 密钥”这是仅限密钥的工具的预期提示。quick_visa_check 仍然可以回答。要解除限制，请将密钥放入配置文件的 env 块中——而不是您的 shell——然后重启客户端
“免密钥每日限额已达”今天 10 次免费检查已用完。免费密钥可解除限制
HTTP 403，“检查 ORIZN_API_KEY 是否有拼写错误”密钥错误、已吊销或包含空白字符
HTTP 403，“需要 Hobby 或以上套餐”密钥正确，但套餐不对——此工具是付费的
HTTP 429月度配额已用完
HTTP 404（针对真实国家）使用 alpha-3 代码（FRA, JPN），而非 alpha-2（FR, JP）
完全无法工作调用 get_coverage_stats——它不需要密钥。如果这也失败，那就是网络问题
get_recent_changes 返回空列表预期行为——信息流正在重建中。这并不意味着规则没有变化

链接

许可证

MIT