io.github.ahmedvnabil/egypt-research (MCP) Server

This MCP server provides research for Egyptian public affairs by searching Egyptian news, public records, and general data. Results are tied to their sources, supporting researchers and journalists. It’s presented as “ERX — Egypt Research Commons” and is associated with an ERX website at https://erx-mcp.zad.tools.

🛠️ Key Features

Search Egyptian news
Search public records and general public data
Tie each result to its source
Server name: io.github.ahmedvnabil/egypt-research
Tool count: 21

🚀 Use Cases

Research Egyptian public affairs
Find sources for Egyptian news items
Access public records and data for reporting and analysis

⚡ Developer Benefits

Enables source-grounded research workflows for Egyptian topics
Includes implementation focus (TypeScript) via topic metadata
Exposes 21 tools through MCP

⚠️ Limitations

No additional tool behaviors, endpoints, or data coverage details are provided in the source excerpt

📌 Topics

arabic, egypt, mcp, open-data, research, typescript

ERX: من سؤال عن الشأن المصري إلى مصادر وأدلة قابلة للاستشهاد

ERX — Egypt Research Commons

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

محرك بحث وأرشيف للأخبار المصرية والوثائق والبيانات العامة، للباحثين والصحفيين.
Search Egyptian news, public records and data with every result tied to its source.

الموقع · البحث · التوثيق · الهوية · المعمارية

أكثر من ألف وثيقة، 35 مصدرًا تشغيليًا، 21 أداة MCP، و97 اختبارًا ناجحًا

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

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

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

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

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

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

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

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

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

text

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

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

json

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

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

bash

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 من المصادر المباشرة إلى واجهة الويب وMCP وREST والتصدير

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

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

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

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

bash

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

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

bash

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:

bash

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

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

bash

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.

لوحة الهوية البصرية لـ ERX

اسأل. قارن. استشهد.

query	string	required
source_types	array	optional
date_from	string	optional
date_to	string	optional
limit	integer	optional
offset	integer	optional

query	string	required
limit	integer	optional

query	string	required
limit	integer	optional

source_type	string	optional
active_only	boolean	optional
limit	integer	optional
offset	integer	optional

date	string	required
limit	integer	optional
offset	integer	optional

document_id	integer	optional
limit	integer	optional
offset	integer	optional

source	string	required
indicator	string	optional
query	string	optional
country	string	optional
period_from	string	optional
period_to	string	optional
period	string	optional
limit	integer	optional
refugee_dimension	string	optional
flow_code	string	optional

io.github.ahmedvnabil/egypt-research (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

📌 Topics

Topics

egypt_search

egypt_get_document

egypt_build_timeline

egypt_compare_sources

egypt_get_source_profile

egypt_list_sources

egypt_get_daily_brief

egypt_list_stories

egypt_export_references

egypt_hybrid_search

egypt_research_dossier

egypt_find_entities

egypt_list_events

egypt_trace_claim

egypt_compare_claims

egypt_list_live_datasets

egypt_get_live_data

egypt_compare_live_data

egypt_live_source_health

egypt_get_coverage

egypt_save_research_query

ERX — Egypt Research Commons

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

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

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

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

أدوات MCP

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

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

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

كيف يعمل

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

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

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

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

Install

Related servers