Zum Inhalt springen
MCP ThesaurusMCP Thesaurus

Egypt Research Commons

CommunityIncomplete39/100Beanspruchen

npm egypt-research-mcpstreamable-httpMITupdated 25d ago

تابع الشأن المصري. ارجع إلى المصدر. · Follow Egyptian public affairs. Return to the source.

QuellcodeWebsite

Was kannst du mit Egypt Research Commons machen?

ابحث في مصر، لا في الضوضاء

ERX موجه للباحث والصحفي الذي يبدأ بسؤال عن الشأن المصري: قرار حكومي، مؤشر اقتصادي، تشريع، قضية حقوقية، خدمة عامة، أو طريقة تناول المصادر لخبر واحد. يجمع المواد الإخبارية والوثائق الرسمية والقانونية والأكاديمية والبيانات العامة، ثم يربط كل نتيجة بالرابط الأصلي وتاريخ النشر وسياق الظهور وسبب الترتيب.

ERX ليس وسيلة إعلام ولا يقرر صحة الادعاء نيابة عن الباحث. هو مساحة بحث قابلة للمراجعة تساعدك على الانتقال من السؤال → المصادر → الأدلة → الاستشهاد.

ماذا يمكنك أن تبحث؟

الملف أمثلة عملية
السياسة والاقتصاد تتبع قرار حكومي، مقارنة التغطية، وربطه بالموازنة أو المؤشرات العامة
القانون والحقوق الوصول إلى التشريع أو الحكم أو البيان الأصلي ومتابعة تطور القضية
المجتمع والخدمات العامة بحث الصحة والتعليم والعمل والسكان عبر الأخبار والبيانات
الإعلام والخطاب العام مقارنة العناوين والمواقف وتنوع الناشرين عبر فترة زمنية

ابدأ من واجهة البحث دون حساب. ويمكن للمطورين ووكلاء الذكاء الاصطناعي استخدام طبقة MCP وREST نفسها بعد ذلك — مع مكتبتَي عميل Python وTypeScript، ودليل الاستخدام، ومعرّفات استشهاد ثابتة وأمر dataset-dump لتصدير نسخة أرشيف قابلة للاستشهاد.

ما الذي يقدمه ERX؟ كيف يبقى قابلًا للمراجعة؟
بحث عربي نصي ودلالي سبب ترتيب واضح لكل نتيجة
مقارنة التغطيات والادعاءات رابط الوثيقة والناشر والتاريخ
خط زمني وكيانات وأحداث فصل تاريخ الحدث عن النشر والأرشفة
بيانات عامة حية الترخيص ووقت الجلب والرابط الأصلي
تصدير RIS وBibTeX وCSV وJSONL نقل المراجع دون فقدان المصدر

ابدأ خلال دقيقة

نقطة MCP العامة:

https://erx-mcp.zad.tools/mcp

مثال لعميل يدعم Streamable HTTP:

{
  "mcpServers": {
    "egypt-research": {
      "url": "https://erx-mcp.zad.tools/mcp"
    }
  }
}

أو شغّله محليًا عبر stdio:

npx -y egypt-research-mcp serve --transport stdio

السطوح المتاحة

السطح المسار الاستخدام
الصفحة الرئيسية / تعريف المنتج وحالة الأرشيف
واجهة الباحث /explore بحث عربي دون حساب، مع أمثلة استعلامات موجّهة
خريطة المعرفة /knowledge كيانات وأحداث وادعاءات
من نحن /about المهمة والمنهجية والجهة المشغّلة
الخصوصية /privacy ما لا نسجّله ولا نتتبعه
السلامة للباحثين /safety إرشادات البحث في الموضوعات الحساسة
توثيق API /docs المسارات وأمثلة الاستخدام مع سنيبتات التثبيت
MCP /mcp Streamable HTTP للوكلاء
REST API /api/v1 تكاملات مستقرة، ترقيم، OpenAPI 3.1، رؤوس معدّل
خلاصة RSS /feed.xml أحدث الوثائق للمتابعة
الحالة /status.html لوحة حالة بشرية للأرشيف
الجاهزية /readyz فحص سلامة قاعدة البيانات
المقاييس /metrics مقاييس Prometheus

أدوات MCP

البحث والتتبع

الأداة الوظيفة
egypt_search بحث حسب النص ونوع المصدر والفترة
egypt_hybrid_search بحث نصي ودلالي مع تفسير الترتيب
egypt_get_document وثيقة كاملة مع بيانات الاستشهاد
egypt_research_dossier نتائج وخط زمني وكيانات وادعاءات في طلب واحد
egypt_trace_claim تتبع الادعاء إلى الأدلة التي أوردته
egypt_compare_claims تجميع الادعاءات المتشابهة ومقارنة المواقف

المقارنة والتنظيم

الأداة الوظيفة
egypt_compare_sources مقارنة التغطية حسب نوع المصدر
egypt_build_timeline بناء خط زمني موثق
egypt_list_stories قصص متقاربة مع تنوع الناشرين
egypt_find_entities الكيانات ومواضع ظهورها
egypt_list_events الأحداث المؤرخة ووثائقها
egypt_get_daily_brief مواد يوم محدد وتنوع مصادرها
egypt_list_sources عرض كتالوج المصادر التشغيلية
egypt_get_source_profile بيانات المصدر وصحة الجمع

البيانات والتصدير

الأداة الوظيفة
egypt_list_live_datasets كتالوج مجموعات البيانات العامة
egypt_get_live_data جلب مؤشر أو سجل حي مع بيانات المصدر
egypt_compare_live_data مقارنة سلاسل مع تنبيه اختلاف المنهجيات
egypt_live_source_health فحص صحة موفري البيانات الحية
egypt_export_references تصدير RIS وBibTeX وCSV وJSONL
egypt_get_coverage تغطية الأرشيف وصحة المصادر
egypt_save_research_query حفظ استعلام متابعة محليًا؛ معطلة على نقطة MCP العامة

توجد أيضًا موارد egypt://sources وegypt://taxonomy وegypt://methodology، وprompts للبحث المنظم والتحقق من الادعاءات. راجع src/mcp.ts للتعريف التنفيذي الكامل.

كيف يعمل

  • يجمع ERX من 35 مصدرًا تشغيليًا رسميًا وقانونيًا وأكاديميًا وإحصائيًا وحقوقيًا وإخباريًا وحقوقيًا. المصدر المغلق أو المتوقف لا يظهر في الكتالوج التشغيلي.
  • يحترم robots.txt، ويطبّق تأخيرًا مستقلًا لكل مصدر وحدودًا للحجم والصفحات.
  • يستخرج HTML وPDF، ويستخدم OCR عربيًا محدود الموارد عند غياب طبقة النص.
  • يحتفظ بإصدارات الوثيقة عند تغير محتواها وبسجل لكل عملية جمع.
  • يستبعد الرياضة والترفيه والأخبار الدولية غير المرتبطة بمصر من البحث مع إبقائها في الأرشيف للمراجعة.
  • يستخدم SQLite FTS5 وتمثيلًا دلاليًا محليًا قابلًا للتفسير، مع دعم اختياري لـ Gemini Embeddings عبر GEMINI_API_KEY.

التفاصيل: المعمارية · التشغيل · نموذج التهديد.

التطوير المحلي

يتطلب Node.js 24 أو أحدث وnpm.

git clone https://github.com/ahmedvnabil/erx.git
cd erx
npm ci
npm run build
node dist/cli.js init
node dist/cli.js seed
node dist/cli.js serve --transport http --host 127.0.0.1 --port 8000

جمع البيانات وبناء الفهرس:

node dist/cli.js ingest
node dist/cli.js audit-sources --concurrency 10
node dist/cli.js index --provider local
node dist/cli.js rebuild-stories
node dist/cli.js rebuild-events
node dist/cli.js restore-excluded
node dist/cli.js health
node dist/cli.js status

أو عبر Docker:

docker compose build
docker compose run --rm egypt-research node dist/cli.js seed
docker compose up -d

الاختبارات والإصدار

npm run check
npm test
npm run test:coverage
npm run build
npm run release:check

عند إنشاء tag، ينشر المشروع حزمة npm وبيانات MCP Registry وصورة متعددة المعماريات على GitHub Container Registry. راجع قائمة الإطلاق وتقرير QA.

حدود المنهجية

  • ERX لا يمنح المصادر درجة حقيقة آلية.
  • تكرار الادعاء لا يعني تحققًا مستقلًا.
  • تجميع القصص تشابه نصي مساعد، وليس حكمًا تحريريًا.
  • الرابط الأصلي يظل المرجع النهائي.
  • الكود مرخص MIT؛ حقوق المواد المفهرسة تبقى لأصحابها.

الهوية والمساهمة

يشرح دليل الهوية العلامة، الألوان، نبرة الصوت، والاستخدام الصحيح للشعار. للمساهمة راجع CONTRIBUTING.md و CODE_OF_CONDUCT.md. للإبلاغ الأمني استخدم SECURITY.md.