Orizn Visa

เซิร์ฟเวอร์ MCP สำหรับ API Orizn Visa

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 สามารถส่งเป็นอาร์กิวเมนต์ได้เช่นกัน ซึ่งจะมีความสำคัญเหนือกว่าตัวแปรสภาพแวดล้อม:

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 แห่งสำหรับพาสปอร์ตหนึ่งเล่มแบบเทียบเคียง: ข้อกำหนด วันปลอดวีซ่า คำอธิบาย อายุพาสปอร์ต ค่าธรรมเนียม ความปลอดภัย สุขภาพ วัคซีน ประกันภัย การเข้าประเทศตามรูปแบบ วีซ่าทำงานระยะไกล แต่ละปลายทางที่ส่งกลับนับเป็นหนึ่งคำขอ	Hobby ขึ้นไป
check_transit_visa	passport, transit_country, lang	เฉพาะกฎการแวะพักเครื่อง: ผู้เดินทางสามารถอยู่ในโซน airside หรือออกจากสนามบินระหว่างต่อเครื่องได้หรือไม่ และสนามบินหลักให้เวลาต่อเครื่องฟรีกี่ชั่วโมง	Hobby ขึ้นไป
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 ส่งเป็น header x-api-key ไปยัง https://visa.orizn.app/api/v1/visa

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

Hobby ราคา $9/เดือน สำหรับ 10,000 คำขอ และปลดล็อกทั้งหมด: อัปเกรด แผนปริมาณสูงมีอยู่ในหน้าปricing

ส่ง key ในบล็อก env ของการกำหนดค่า MCP — MCP client ไม่สืบทอดสภาพแวดล้อม shell ของคุณ ดังนั้นการ export 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 Hobby 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