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 即時讀取（也可在 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 }

疑難排解

症狀修正方式
「沒有 Orizn API 金鑰」僅限金鑰的工具會出現此訊息。quick_visa_check 仍可回答。若要解除，請將金鑰放入設定檔的 env 區塊——而非你的 shell——然後重新啟動用戶端
「免金鑰每日上限已達」今日 10 次免費檢查已用完。免費金鑰可解除此上限
HTTP 403、「檢查 ORIZN_API_KEY 是否有拼寫錯誤」金鑰錯誤、已撤銷，或含有空白字元
HTTP 403、「需要 Starter 方案或以上」金鑰正確但方案不符——此工具為付費功能
HTTP 429每月配額已用完
真實國家卻出現 HTTP 404使用 alpha-3 代碼（FRA、JPN），而非 alpha-2（FR、JP）
完全無法運作呼叫 get_coverage_stats——它不需要金鑰。如果連這個也失敗，那就是網路問題
get_recent_changes 回傳空清單符合預期——資訊源正在重建中。這不代表規則沒有變更

連結

授權

MIT