إعداد MCP
موصى بهيوفر MCP للوكيل ثلاث أدوات حساب للقراءة فقط عبر stdio. يبقى الخادم على جهازك ولا يحتاج إلى حساب SCHNGN أو مفتاح API.
التحقق من الاتصال
أعد تشغيل عميل MCP أو حدّثه، ثم اطلب منه إدراج أدوات SCHNGN. ينبغي أن ترى العمليات الثلاث أدناه.
codex mcp get schngn --json مهارة الوكيل
تعلّم المهارة الوكيل متى يستدعي SCHNGN وكيف ينشئ نطاقات إقامة صريحة ومتى يرفض أسئلة الوضع القانوني.
ما الذي تضيفه المهارة
- تفضّل أدوات MCP بدلًا من إعادة تنفيذ حساب التواريخ.
- تقصر المدخلات على تواريخ الدخول والخروج للإقامات المتصلة في شنغن.
- تلتزم بتخطيط الإقامة القصيرة العادية وتحيل الحالات الاستثنائية إلى السلطات الرسمية.
الواجهة
CLI
استخدم JSON CLI في البرامج النصية وأصداف الوكلاء. يقرأ JSON صارمًا من stdin أو من ملف ويعيد نتيجة JSON واحدة.
الأوامر: schngn usage وschngn check-stay وschngn latest-exit.
schngn usage --input request.json الواجهة
REST + OpenAPI
شغّل خدمة HTTP محصورة في loopback للأدوات التي تستخدم REST. توفر مستند OpenAPI محدثًا وترفض عناوين الربط غير المحلية.
OpenAPI: http://127.0.0.1:37491/openapi.json
schngn-api الواجهة
TypeScript
استورد engine النقي لحسابات التواريخ منخفضة المستوى أو حزمة capability لعقد الوكيل الصارم.
الحزم: @schngn/engine و@schngn/capability
npm install @schngn/capability import { calculateUsage } from '@schngn/capability';
const result = calculateUsage({
stays: [{ entryDate: '2026-01-01', exitDate: '2026-01-12' }],
referenceDate: '2026-02-01'
});مرجع الأدوات
تعرض كل واجهة عقد الحساب نفسه والمحدد بالإصدار. تستخدم التواريخ تنسيق YYYY-MM-DD وتشمل نطاقات الإقامة يومي الدخول والخروج.
calculate_schengen_usage
- المدخلات
{ stays, referenceDate, includeCountedDays? }- الغرض
- حساب الأيام المستخدمة والمتبقية في تاريخ مرجعي صريح.
check_schengen_stay
- المدخلات
{ existingStays, candidateStay }- الغرض
- فحص كل يوم من إقامة متصلة مقترحة.
latest_safe_schengen_exit
- المدخلات
{ existingStays, entryDate }- الغرض
- العثور على آخر خروج آمن لإقامة ذات تاريخ دخول معروف.
حدود الخصوصية
حدود الحساب محلية، لكن مسار الوكيل الكامل قد يشمل خدمات سحابية.
LOCAL
بيئة تشغيل SCHNGN
لا تحفظ بيئة التشغيل البيانات ولا ترسل القياس عن بعد ولا تسجل التواريخ المقدمة ولا تنفذ طلبات شبكة صادرة.
HOST
مضيف الوكيل ومزود النموذج
قد يرسل عميل MCP أو مضيف الوكيل التعليمات ووسائط الأدوات والنتائج إلى مزود النموذج. راجع سياسات الخصوصية والاحتفاظ لديه قبل استخدام تواريخ سفر حقيقية.
المتطلبات
Node.js 24 أو أحدث. لا يتطلب الحساب حساب SCHNGN أو مفتاح API أو نقطة نهاية مستضافة أو اتصالًا بالشبكة.
النطاق والقيود
تمثل هذه الإمكانية إقامات متصلة وصريحة وفق قاعدة شنغن 90/180 يومًا العادية. ولا تصنف البلدان أو تقرر حقوق التأشيرة أو الإقامة أو تطبق الاتفاقيات الثنائية أو تقدم مشورة قانونية.
أداة مساعدة للتخطيط فقط. تحدد السلطات المختصة مدة الإقامة المصرح بها.