Orizn Visa

官方

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

GitHub
1

你可以用 Orizn Visa MCP 做什么？

  • 查看签证要求 — 通过 check_visa_requirement 查询任何护照/目的地组合的完整入境规则，包括所需文件、费用和处理时间。
  • 快速签证状态 — 使用 quick_visa_check 获取一行式签证要求答案（无需 API 密钥，每日 10 次免费查询）。
  • 比较目的地 — 使用 compare_destinations 查看一本护照对应的最多 25 个国家并排比较，涵盖费用、安全性和健康要求。
  • 过境签证规则 — 通过 check_transit_visa 查询中转停留期间能否离开机场，以及枢纽机场提供多少免费过境小时数。
  • 覆盖统计 — 使用 get_coverage_stats 检查数据库规模和需求类型分布（无需密钥即可使用）。

文档

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 个目的地并排比较：要求、免签天数、描述、护照有效期、费用、安全、健康、疫苗接种、保险、按方式入境、远程工作签证。每个返回的目的地计为一次请求。Starter 或以上
check_transit_visapassport, transit_country, lang仅过境规则：旅客在中转时是否可以留在空侧或离开机场，以及主要枢纽提供多少免费过境小时数。Starter 或以上
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 免费获取——无需信用卡。免费套餐为每月 100 次请求（确认邮箱地址前为 5 次），包含核心字段和全部 15 种语言。在免费套餐中，更深层的字段——费用、办理天数、照片规格、疫苗接种、保险、过境签证、按方式入境、逾期罚款、远程工作签证、大使馆——将以 {"upgrade": "..."} 占位符形式返回，且 compare_destinations 和 check_transit_visa 受到限制。

Starter 套餐为每月 49 美元，含 30,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 }

故障排查

症状解决方法
“No Orizn API key”仅密钥工具的正常提示。quick_visa_check 仍可回答。要解除限制，请将密钥放入配置文件的 env 块中——而非您的 shell——然后重启客户端
“Keyless daily limit reached”今天的 10 次免费检查已用完。免费密钥可解除限制
HTTP 403，“check ORIZN_API_KEY for typos”密钥错误、已撤销或包含空白字符
HTTP 403，“requires Starter plan or above”密钥正确但套餐不符——该工具为付费功能
HTTP 429月度配额已用完
HTTP 404（针对真实国家）请使用 alpha-3 代码（FRA, JPN），而非 alpha-2（FR, JP）
完全无法工作调用 get_coverage_stats——它无需密钥。如果这也失败，则是网络问题
get_recent_changes 返回空列表正常现象——信息源正在重建。这并不意味着规则未变更

链接

许可证

MIT