ERX — Egypt Research Commons

كل معلومة لها مصدر. بحث عربي موثّق للشأن المصري للباحثين والصحفيين ووكلاء 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 متسقان مع فحص سلامة ونسخة أمان قبل الاستعادة.

Related MCP server: bora-mcp

أدوات MCP

يوفر السيرفر أيضًا موارد 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 وبوابة موثوقة وتحديد معدل موزع عند تشغيل عدة نسخ عامة.