Orizn Visa

เซิร์ฟเวอร์ MCP ของ Orizn Visa API

Orizn Visa API MCP Server คือเซิร์ฟเวอร์ Model Context Protocol (MCP) ที่ช่วยให้ผู้ช่วย AI ตอบคำถามเกี่ยวกับข้อกำหนดด้านวีซ่าและการเข้าประเทศสำหรับคู่พาสปอร์ต/ปลายทางใด ๆ ได้ใน 15 ภาษา

ฐานข้อมูลมีการเติบโตอย่างต่อเนื่อง แทนที่จะพิมพ์ตัวเลขที่อาจล้าสมัยที่นี่ เครื่องมือ get_coverage_stats จะอ่านข้อมูลสดจาก API (ซึ่งเปิดเผยต่อสาธารณะที่ https://visa.orizn.app/api/v1/visa/stats ด้วย)

เครื่องมือนี้ตอบคำถามเช่น "ฉันต้องมีวีซ่าเพื่อเดินทางจากฝรั่งเศสไปญี่ปุ่นหรือไม่" "พลเมืองสหรัฐฯ ต้องใช้เอกสารอะไรบ้างในการเข้าจีน" "ฉันออกจากสนามบินระหว่างต่อเครื่องที่อิสตันบูลด้วยพาสปอร์ตอินเดียได้ไหม" — ด้วยข้อมูลจริง ไม่ใช่การคาดเดา

ความเข้ากันได้

เซิร์ฟเวอร์รองรับ MCP ผ่าน stdio และทำงานบน Node.js 18 ขึ้นไป ใช้งานได้กับ MCP client ใดก็ได้ที่สามารถเปิดใช้เซิร์ฟเวอร์ stdio ได้ รวมถึง Claude Desktop, Claude Code และ Cursor บล็อกการกำหนดค่าด้านล่างเหมือนกันสำหรับทุกแพลตฟอร์ม

การติดตั้ง

npx orizn-visa-mcp

ไม่ต้อง build ไม่ต้อง clone เพิ่มลงในการกำหนดค่า MCP client ของคุณ:

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

รีสตาร์ท client แล้วถามว่า: "ฉันต้องมีวีซ่าเพื่อเดินทางจากฝรั่งเศสไปญี่ปุ่นหรือไม่" — ใช้งานได้โดยไม่ต้องใช้ API key 10 ครั้งต่อวัน

สำหรับฟีเจอร์อื่น ๆ (เอกสาร ค่าธรรมเนียม ระยะเวลาดำเนินการ กฎการต่อเครื่อง 15 ภาษา) เพิ่ม key ฟรี:

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

key สามารถส่งเป็น argument ได้เช่นกัน ซึ่งจะมีความสำคัญเหนือกว่าตัวแปรสภาพแวดล้อม:

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_requirement	passport, destination, lang	ข้อกำหนดการเข้าประเทศแบบครบถ้วนสำหรับพาสปอร์ตหนึ่งเล่มเข้าสู่ปลายทางหนึ่งแห่ง: ประเภทข้อกำหนด จำนวนวันที่อนุญาต เอกสาร ขั้นตอนการยื่นคำขอ ค่าธรรมเนียม ระยะเวลาดำเนินการ อายุพาสปอร์ต ข้อกำหนดรูปถ่าย วัคซีน ประกัน คำแนะนำด้านความปลอดภัย ค่าปรับการอยู่เกินกำหนด การเข้าประเทศทางอากาศ/ทางบก/ทางทะเล วีซ่าทำงานระยะไกล กฎการต่ออายุและผู้เยาว์ สถานทูต	key ใดก็ได้
quick_visa_check	passport, destination	หนึ่งบรรทัด: รหัสข้อกำหนด จำนวนวันปลอดวีซ่า และวันที่ตรวจสอบคู่ดังกล่าวล่าสุด ไม่มีเอกสาร ไม่มีค่าธรรมเนียม ไม่มีการแปล	ไม่มี — 10 ครั้ง/วันแบบไม่มี key ไม่จำกัดเมื่อมี key
compare_destinations	passport, destinations (1–25), lang	ปลายทางสูงสุด 25 แห่งสำหรับพาสปอร์ตหนึ่งเล่มแบบเทียบเคียง: ข้อกำหนด วันปลอดวีซ่า คำอธิบาย อายุพาสปอร์ต ค่าธรรมเนียม ความปลอดภัย สุขภาพ วัคซีน ประกัน การเข้าประเทศตามรูปแบบ วีซ่าทำงานระยะไกล แต่ละปลายทางที่ส่งกลับนับเป็นหนึ่งคำขอ	Starter ขึ้นไป
check_transit_visa	passport, transit_country, lang	เฉพาะกฎการต่อเครื่อง: ผู้เดินทางสามารถอยู่ในโซน airside หรือออกจากสนามบินระหว่างต่อเครื่องได้หรือไม่ และสนามบินหลักให้เวลาต่อเครื่องฟรีกี่ชั่วโมง	Starter ขึ้นไป
get_coverage_stats	ไม่มี	ขนาดของฐานข้อมูล: คู่ พาสปอร์ต ปลายทาง การแปล ภาษา และการกระจายของประเภทข้อกำหนด ไม่ระบุเกี่ยวกับคู่ใดคู่หนึ่งโดยเฉพาะ	ไม่มี
get_recent_changes	passport, 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 — รหัส 15 ภาษาที่ยอมรับโดย lang ใช้ได้กับทุกแผนรวมถึงแผนฟรี: 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 key เลย quick_visa_check แบบไม่มี key จำกัดที่ 10 ครั้งต่อวัน — โควตาเดียวกันกับที่ visa.orizn.app ให้ผู้เยี่ยมชมที่ไม่ระบุตัวตน เกินกว่านั้นเครื่องมือจะแจ้งและชี้ไปที่ key ฟรีแทนที่จะล้มเหลวอย่างเงียบ ๆ ขีดจำกัดนี้ต่อกระบวนการเซิร์ฟเวอร์ที่รันอยู่และรีเซ็ตที่ 00:00 UTC

เครื่องมืออีกสามตัวต้องใช้ API key ส่งเป็นส่วนหัว x-api-key ไปยัง https://visa.orizn.app/api/v1/visa

รับ key ฟรีได้ที่ visa.orizn.app/visa-api — ไม่ต้องใช้บัตรเครดิต ระดับฟรีคือ 100 คำขอ/เดือน (5 ครั้งจนกว่าคุณจะยืนยันอีเมล) และรวมฟิลด์หลักและทั้ง 15 ภาษา ในแผนฟรี ฟิลด์เชิงลึก — ค่าธรรมเนียม จำนวนวันดำเนินการ ข้อกำหนดรูปถ่าย วัคซีน ประกัน วีซ่าต่อเครื่อง การเข้าประเทศตามรูปแบบ ค่าปรับการอยู่เกินกำหนด วีซ่าทำงานระยะไกล สถานทูต — จะส่งกลับเป็นตัวยึดตำแหน่ง {"upgrade": "..."} และ compare_destinations และ check_transit_visa ถูกจำกัดการเข้าถึง

Starter ราคา $49/เดือนสำหรับ 30,000 คำขอ และปลดล็อกทั้งหมด พร้อมใบอนุญาตเชิงพาณิชย์: อัปเกรด แผนปริมาณสูงกว่ามีอยู่ในหน้าปricing

ส่ง key ในบล็อก env ของการกำหนดค่า MCP — MCP client ไม่สืบทอดสภาพแวดล้อม shell ของคุณ ดังนั้นการส่งออก ORIZN_API_KEY ในเทอร์มินัลไม่เพียงพอ

ตรวจสอบ key โดยไม่ต้องใช้ MCP client:

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"	เป็นเรื่องปกติสำหรับเครื่องมือที่ต้องใช้ key quick_visa_check ยังตอบได้ เพื่อแก้ไข ใส่ key ในบล็อก env ของไฟล์กำหนดค่า — ไม่ใช่ shell ของคุณ — แล้วรีสตาร์ท client
"Keyless daily limit reached"	การตรวจฟรี 10 ครั้งของวันนี้หมดแล้ว key ฟรีจะลบขีดจำกัด
HTTP 403, "check ORIZN_API_KEY for typos"	key ผิด ถูกเพิกถอน หรือมีช่องว่าง
HTTP 403, "requires Starter plan or above"	key ถูกต้อง แต่แผนผิด — เครื่องมือนี้ต้องชำระเงิน
HTTP 429	โควตารายเดือนหมดแล้ว
HTTP 404 สำหรับประเทศจริง	ใช้รหัส alpha-3 (FRA, JPN) ไม่ใช่ alpha-2 (FR, JP)
ไม่มีอะไรทำงานเลย	เรียก get_coverage_stats — ไม่ต้องใช้ key หากล้มเหลวด้วย แสดงว่าเป็นปัญหาเครือข่าย
get_recent_changes ส่งคืนรายการว่าง	เป็นเรื่องปกติ — ฟีดกำลังถูกสร้างใหม่ ไม่ได้หมายความว่ากฎไม่มีการเปลี่ยนแปลง

ลิงก์

• เว็บไซต์ — visa.orizn.app
• เอกสาร API — visa.orizn.app/visa-api/dashboard/docs
• รับ key ฟรี — visa.orizn.app/visa-api
• GitHub — github.com/MattJeff/orizn-mcp-server
• สนับสนุน — api@orizn.app

สัญญาอนุญาต

MIT