DragonMCP: الاستعلام عن بيانات هونغ كونغ العامة للطقس وMTR والحدود

لمن يناسب

إذا كنت تريد أن يستعلم وكيل عن بيانات عامة مباشرة حول هونغ كونغ وحدود البرّ، بدل أن تربط بنفسك واجهات مفتوحة متعددة، فهذه الخدمة تناسب. تصفها الوثائق الرسمية بأنها خادم MCP للوكلاء يقدّم بيانات عامة قابلة للتحقق.

يناسب من ثبّت بالفعل Node.js 18 أو أحدث ويستطيع استنساخ المستودع محليًا ثم تشغيل عملية stdio بـ node. أدوات هونغ كونغ لا تحتاج .env. إن أردت أدوات Amap، تطلب الوثائق الرسمية نسخ القالب ثم ملء سر؛ لا تسلك هذا المسار في المحاولة الأولى. ابدأ بأدوات هونغ كونغ بلا سر.

ليست أرشيفًا بلا اتصال: كل أداة تستدعي واجهة حية، بلا mock. إن تعذّر المصدر الأعلى تقول الأداة ذلك مباشرة ولا تخترع إجابة تبدو معقولة.

إكمال المحاولة الأولى في 3 دقائق

المسار الرسمي الموصى به هو الاستنساخ المحلي ثم البناء. الشرط المسبق: Node.js 18 أو أحدث على هذا الجهاز. استعلامات طقس هونغ كونغ لا تحتاج متغيرات بيئة.

اتبع الخطوات الرسمية:

git clone https://github.com/arthurpanhku/DragonMCP.git
cd DragonMCP
npm install
npm run build

بعد البناء، في عميل MCP اجعل command يساوي node وargs يشير إلى dist/stdio.js داخل نسخة هذا الجهاز. الأمثلة الرسمية تستخدم مسارًا مطلقًا نائبًا؛ استبدله بالمسار الحقيقي بعد استنساخك. لا تنسخ مجلد النائب. احفظ وأعد تحميل العميل وتأكد أن الخدمة متصلة.

ثم نفّذ استعلامًا للقراءة فقط: استدعِ hk_weather_current. يقول الجدول الرسمي إنه يتصل بمرصد هونغ كونغ، للاستخدام في الطقس الحالي والتحذيرات السارية. الجدول لا يكتب حقول المعاملات؛ استدعِ وفق تعريف الأداة الذي يعرضه العميل. لا تخترع رقم محطة ولا معاملًا لم يظهر.

إشارة النجاح: يعود الطقس الحالي والتحذيرات السارية. إن تعذّر المصدر الأعلى تشرح الأداة ذلك بدل اختراع طقس. يمكنك أيضًا استدعاء system_run_selftest، فيستكشف كل مصدر أعلى ويبلّغ أيها قابل للوصول الآن؛ هذا مسار التحقق الرسمي لا خطوة إلزامية في المحاولة الأولى.

حالات الاستخدام

الحالة الأولى: استعلم عن طقس هونغ كونغ الحالي والتحذيرات. استدعِ hk_weather_current. تقول الوثائق الرسمية إنه يتصل بمرصد هونغ كونغ ويعيد Current conditions + active warnings. لا جدول حقول ولا محطة مثال؛ عند النجاح يجب أن ترى الأحوال الحالية والتحذيرات السارية، وتعاملها كنتيجة واجهة مباشرة لا ذاكرة بلا اتصال.

الحالة الثانية: استعلامات رحلات MTR والوصول. استدعِ search_mtr_schedule. تقول الوثائق الرسمية إن البيانات من data.gov.hk، لتخطيط رحلات التحويل والوصول المباشر، وتغطي كل الخطوط الـ10، و98 محطة. لا تكتب كيف تُمرَّر نقطة الانطلاق والوصول؛ استخدم فقط الحقول التي يعرضها العميل. عند النجاح يجب أن ترى معلومات رحلة أو وصول. لا تفهمها على أنها تغيير للجدول الزمني.

الصفحة نفسها تسمّي أيضًا hk_typhoon_signal، لحالة منظّمة للأعاصير والأمطار الغزيرة وغيرها من التحذيرات السارية، وتتصل كذلك بمرصد هونغ كونغ. لا يلزم استدعاؤه في المحاولة الأولى.

حدود الاستخدام

الشرط المسبق هو Node.js 18+. أدوات هونغ كونغ بلا .env؛ أدوات Amap تحتاج سرًا وفق القالب الرسمي. هذه الصفحة لا تكتب اسم متغير السر؛ لا تخمّنه في المحاولة الأولى. كل أداة تضرب واجهة حية وتخرج إلى الشبكة وقد تكشف الخط أو موضوع الطقس الذي استعلمت عنه.

لا تكتب الوثائق الرسمية حد معدل ولا حصة ولا عمر ذاكرة مؤقتة. إن سقط المصدر الأعلى تقول الأداة ذلك؛ يمكن لـ system_run_selftest استكشاف قابلية الوصول. لا تراجع ولا تراجع عن التنفيذ. هذه الاستعلامات بيانات عامة للقراءة فقط، لكنها ليست صفر مخاطر.

يجب أن يشير dist/stdio.js في التكوين إلى ناتج البناء على هذا الجهاز. لا تستخدم مسار مصدر غير مبني، ولا تخترع أسماء أدوات برّ لم تُذكر.