ERX — Egypt Research Commons

<p align="center"> <img src="docs/media/erx-gpu-hero.webp" alt="ERX — Egypt Research Commons" width="100%"> </p>

<p align="center"> <img src="docs/media/erx-gpu-loop.gif" alt="ERX MCP flow: research with provenance" width="960"> </p>

كل معلومة لها مصدر. بحث عربي موثّق للشأن المصري للباحثين والصحفيين ووكلاء AI.

التشغيل · أدوات MCP · النشر · الهوية · خطة التسويق

Production: erx-mcp.zad.tools · MCP: https://erx-mcp.zad.tools/mcp

الفكرة في لقطة واحدة: سؤال من الباحث أو الوكيل → أدوات MCP متخصصة → أدلة أصلية قابلة للتتبع.

الإمكانات الحالية

• كتالوج تشغيلي من 24 مصدرًا رسميًا وقانونيًا وأكاديميًا وإحصائيًا وإخباريًا وحقوقيًا؛ المصادر المغلقة أو المتوقفة لا تظهر فيه.
• قنوات جمع مباشرة من RSS وموصلات HTML وواجهات API رسمية، دون الاعتماد على Google News.
• تدقيق حي للمصادر التشغيلية يختبر XML وروابط المقالات وسجلات JSON، ويميز الحجب و429 والتحويلات غير المتوافقة.
• استخراج HTML وPDF، مع طبقة النص أولًا ثم OCR عربي محدود الموارد عند الحاجة.
• احترام robots.txt وسياسة تأخير مستقلة لكل مصدر وحدود للحجم والصفحات.
• أرشفة إصدارات الوثائق عند تغير محتواها.
• تجميع التغطيات المتشابهة في قصص مع إظهار عدد الوثائق وتنوع المصادر.
• استبعاد المواد الرياضية والترفيهية آليًا من طبقة البحث مع الاحتفاظ بها في الأرشيف، وإعادة بناء القصص عبر node dist/cli.js reclassify.
• استبعاد الأخبار الدولية غير المرتبطة بمصر من طبقة البحث مع إبقاء الوثائق المؤرشفة للمراجعة.
• سجل لكل عملية جمع، بما فيها الفشل والمدة وعدد المواد.
• بحث عربي هجين يجمع SQLite FTS5 وتمثيلًا دلاليًا محليًا قابلًا للتفسير.
• دعم اختياري لـ Gemini Embeddings عبر GEMINI_API_KEY.
• حزمة بحث مركبة تجمع النتائج والخط الزمني والكيانات والادعاءات وتنوع المصادر.
• استخراج كيانات وأحداث وادعاءات منسوبة وربطها بالأدلة الأصلية.
• تصنيف الادعاءات إلى إفادة ونفي ومطالبة وتحذير مع إزالة التكرار داخل الوثيقة.
• تصنيف موضوعي عربي قابل للمراجعة.
• روابط واستشهادات أصلية مع تاريخ النشر والأرشفة.
• تصدير CSV وJSONL وBibTeX وRIS.
• واجهة عربية RTL تعمل دون حساب مستخدم.
• Streamable HTTP للاستخدام البعيد وstdio للاستخدام المحلي.
• REST API مستقرة تحت /api/v1 مع وصف OpenAPI.
• طبقة بيانات حية منظمة من World Bank وIMF وWHO وUNHCR وCrossref وUN Comtrade Preview، وكلها بدون Token في المسار العام.
• readiness ومقاييس Prometheus وتحديد معدل ورؤوس أمان.
• نسخ واستعادة SQLite متسقان مع فحص سلامة ونسخة أمان قبل الاستعادة.

أدوات MCP

الأداة	الاستخدام
search_egypt	البحث بالنص ونوع المصدر والفترة الزمنية
get_document	استرجاع وثيقة كاملة مع الاستشهاد
build_timeline	بناء خط زمني لموضوع أو قضية
compare_sources	مقارنة التغطية حسب نوع المصدر
get_source_profile	معلومات المصدر وصحة الجمع
list_sources	عرض كتالوج المصادر
get_daily_brief	مواد يوم محدد وتنوع مصادرها
list_stories	القصص المتقاربة وتنوع ناشريها
export_references	تصدير نتائج قابلة للإدخال في Zotero ومديري المراجع
hybrid_search	بحث نصي ودلالي مع سبب ترتيب كل نتيجة
research_dossier	حزمة بحث موثقة تجمع النتائج والخط الزمني والكيانات والادعاءات
find_entities	الكيانات المستخرجة وعدد الوثائق والظهور
list_events	الأحداث المؤرخة ووثائقها الأصلية
trace_claim	تتبع الادعاء إلى كل دليل ومصدر أورده
compare_claims	تجميع الادعاءات المتشابهة ومقارنة مواقف المصادر
save_research_query	حفظ استعلام متابعة محلي؛ معطلة في نقطة MCP العامة
list_live_datasets	كتالوج مصادر REST/OData الحية العامة وترخيصها
get_live_data	جلب مؤشر أو سجل حي مع الفترة والرابط ووقت الجلب
compare_live_data	جمع سلاسل حية للمقارنة مع تحذير اختلاف المنهجيات
live_source_health	فحص صحة مصادر البيانات الحية وحدود المعدل
get_coverage	تغطية الأرشيف حسب الموضوع وصحة المصادر

يوفر السيرفر أيضًا موارد egypt://sources وegypt://taxonomy وegypt://methodology، بالإضافة إلى prompts للبحث المنظم والتحقق من الادعاءات.

التشغيل

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

npm ci
npm run build
node dist/cli.js init
node dist/cli.js seed
node dist/cli.js ingest
node dist/cli.js ingest --source eipr --full-text
node dist/cli.js ingest --channel sitemap --max-urls 200
node dist/cli.js ingest --channel html --html-max-urls 20
node dist/cli.js ingest --channel api
node dist/cli.js audit-sources --concurrency 10
node dist/cli.js index --provider local
node dist/cli.js reclassify
node dist/cli.js rebuild-stories
node dist/cli.js rebuild-events
node dist/cli.js status

تشغيل واجهة الباحث وMCP معًا:

node dist/cli.js serve --transport http --host 127.0.0.1 --port 8000

عنوان الاتصال:

http://127.0.0.1:8000/mcp

Landing Page: http://127.0.0.1:8000/، واجهة الباحث: /explore، التوثيق: /docs، خريطة المعرفة: /knowledge، الـAPI: /api/v1/openapi.json، والبيانات الحية: /api/v1/live/datasets و/api/v1/live/data?source=world-bank&indicator=SP.POP.TOTL&country=EGY، والتغطية: /api/v1/coverage، والحالة: /api/v1/status، وحالة الجاهزية: /readyz.

تشغيله محليًا عبر stdio:

node dist/cli.js serve --transport stdio

يمكن تغيير قاعدة البيانات عبر --database أو متغير البيئة EGYPT_RESEARCH_DB.

النسخ والاستعادة:

node dist/cli.js backup --output backups/snapshot.db
node dist/cli.js verify-backup --input backups/snapshot.db
node dist/cli.js restore --input backups/snapshot.db --yes

Docker

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

تُحفظ قاعدة البيانات في volume مستقل. أضف مهمة مجدولة خارج الحاوية لتشغيل ingest دوريًا؛ واستخدم --full-text فقط للمصادر التي تسمح بنيتها وسياساتها بذلك. راجع دليل التشغيل للنشر والجدولة والاستعادة.

النشر

المستودع مجهز بثلاث قنوات توزيع متزامنة عند إنشاء tag:

1. حزمة عامة على npm.
2. تسجيل رسمي في MCP Registry باسم io.github.ahmedvnabil/egypt-research.
3. صورة متعددة المعماريات على GitHub Container Registry.

يُنشر الموقع وStreamable HTTP على erx-mcp.zad.tools، بينما ينشر إنشاء tag الحزمة العامة وبيانات MCP Registry وGitHub Release تلقائيًا.

npm run release:check
git tag v0.8.0
git push origin v0.8.0

راجع قائمة الإطلاق وحزمة محتوى الإطلاق. لنتائج الاختبار الحالية، راجع تقرير QA للإصدار 0.16.0.

إضافة المصدر إلى عميل MCP

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

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

الاختبارات

npm run check
npm run test:coverage
npm run build

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

• المنصة لا تمنح المصادر درجة حقيقة آلية.
• تكرار ادعاء في عدة مصادر لا يعني أنه تحقق بصورة مستقلة.
• بعض المصادر موجودة في الكتالوج دون جمع آلي حتى تتوفر لها قناة مباشرة موثقة.
• المحتوى المتاح يعتمد على ما تنشره قناة المصدر؛ يظل الرابط الأصلي هو المرجع النهائي.
• تجميع القصص تشابه نصي مساعد وليس حكمًا تحريريًا أو تحققًا آليًا.
• الكود MIT، لكن حقوق المواد المفهرسة تظل لأصحاب المصادر الأصلية.
• الوضع الافتراضي يربط السيرفر بـ127.0.0.1. يجب إضافة HTTPS وبوابة موثوقة وتحديد معدل موزع عند تشغيل عدة نسخ عامة.