Egypt Research Commons

io.github.ahmedvnabilPublished by GitHub account ahmedvnabilv1.2.0Updated Oct 24, 2026

Source-grounded research for Egyptian public affairs

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingKnowledge & MemoryData & Analytics

Overview

AI-generated overview

Source-grounded research archive for Egyptian public affairs, giving an assistant search, claim tracing, timelines and citation export over news, legal and…

What you can do
  • Search and trace: text and hybrid search, full documents with citation data, claim tracing and claim comparison, research dossiers.
  • Compare and organize: source coverage comparison, timelines, related stories, entities, dated events, daily briefs, source catalog and profiles.
  • Data and export: live public datasets and indicators, series comparison, provider health, archive coverage, reference export to RIS, BibTeX, CSV and JSONL.
  • Also exposes source, taxonomy and methodology resources plus prompts for structured research and claim verification.
When to use it
Useful for researchers, journalists and analysts asking questions about Egyptian government decisions, legislation, economic indicators, rights cases or how outlets covered one story, where every result must stay tied to its original source and date.
Requirements
Hosted MCP endpoint over Streamable HTTP, or a local stdio process via the npm package (Node.js 24 or newer). The hosted endpoint and REST API need a free API key sent as an Authorization Bearer header or X-API-Key; self-hosting needs no key. Optional GEMINI_API_KEY for Gemini embeddings.
Before you install
The hosted service requires signing up with an email and creating an API key that is shown only once; keep it out of shared configs. The free plan is capped at 50,000 calls per month. The save-query tool is disabled on the public endpoint. The project states it does not judge claim truth, so results are leads, not verification.

Installation

In SourceWeft

  1. Open Egypt Research Commons in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.ahmedvnabil%2Fegypt-research/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

[CI]

[واجهة 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.

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

[انتقال فعلي من الرئيسية إلى مستكشف المصادر]

لقطات محلية بتاريخ 24 أكتوبر 2026، بكتالوج المصادر المرفق ومن دون استيراد وثائق. الأرقام في الصور تخص هذه النسخة التجريبية، وليست إحصاءات الخدمة المستضافة.

نتائج الفحص موثقة بتاريخها في تقرير المراجعة.

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

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

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

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

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

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

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

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

  • في المتصفح: واجهة البحث مفتوحة دون حساب.
  • لوكيلك الذكي (MCP) أو REST: النسخة المستضافة تحتاج مفتاحًا مجانيًا: سجّل بريدك من صفحة البداية، وأنشئ مفتاحًا من لوحة المشترك (يظهر مرة واحدة)، ثم أرسله في ترويسة Authorization: Bearer <key> (أو X-API-Key). الخطة المجانية: 50,000 استدعاء شهريًا. التشغيل الذاتي لا يحتاج مفتاحًا.

نقطة MCP المستضافة (Streamable HTTP):

text
https://egypt-research.marsaplatform.com/mcp

Claude Code

bash
claude mcp add --transport http egypt-research https://egypt-research.marsaplatform.com/mcp \  --header "Authorization: Bearer YOUR_API_KEY"

Cursor (~/.cursor/mcp.json) وVS Code (.vscode/mcp.json مع "servers" و"type": "http"):

json
{  "mcpServers": {    "egypt-research": {      "url": "https://egypt-research.marsaplatform.com/mcp",      "headers": { "Authorization": "Bearer YOUR_API_KEY" }    }  }}

Claude Desktop (claude_desktop_config.json، عبر mcp-remote):

json
{  "mcpServers": {    "egypt-research": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://egypt-research.marsaplatform.com/mcp",               "--header", "Authorization: Bearer YOUR_API_KEY"]    }  }}

أو شغّله محليًا عبر stdio دون مفتاح (Node.js 24 أو أحدث):

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

جرّب أن تسأل وكيلك: «تتبّع تغطية قرار رفع أسعار الوقود خلال الشهر الماضي مع المصادر»، أو «قارن كيف تناولت المصادر الرسمية والصحفية قانون العمل الجديد، وصدّر المراجع بصيغة BibTeX».

English quick start

ERX (Egypt Research Commons) is a source-grounded research archive and MCP server for Egyptian public affairs: 35 operational sources, 21 read-only egypt_* MCP tools, and every result tied to its original URL, publisher and dates.

  • Web search: https://egypt-research.marsaplatform.com/explore — open, no account.
  • Hosted MCP: https://egypt-research.marsaplatform.com/mcp and REST …/api/v1 need a free API key (sign up at https://egypt-research.marsaplatform.com/#signup, create a key in the dashboard, send Authorization: Bearer <key>). Free plan: 50,000 calls/month.
  • Self-hosted (no key): npx -y egypt-research-mcp serve --transport stdio (Node ≥ 24).
  • Connect snippets for Claude Code, Claude Desktop, Cursor and VS Code are above and in docs/USAGE.md. Health: /health · status: /status.html · API docs: /docs.

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

السطحالمسارالاستخدام
الصفحة الرئيسية/تعريف المنتج وحالة الأرشيف
واجهة الباحث/exploreبحث عربي دون حساب، مع أمثلة استعلامات موجّهة
خريطة المعرفة/knowledgeكيانات وأحداث وادعاءات
من نحن/aboutالمهمة والمنهجية والجهة المشغّلة
الخصوصية/privacyما لا نسجّله ولا نتتبعه
السلامة للباحثين/safetyإرشادات البحث في الموضوعات الحساسة
توثيق API/docsالمسارات وأمثلة الاستخدام مع سنيبتات التثبيت
MCP/mcpStreamable 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/marsaplatform/erx-mcp.gitcd erx-mcpnpm cinpm run buildnode dist/cli.js initnode dist/cli.js seednode dist/cli.js serve --transport http --host 127.0.0.1 --port 8000

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

bash
node dist/cli.js ingestnode dist/cli.js audit-sources --concurrency 10node dist/cli.js index --provider localnode dist/cli.js rebuild-storiesnode dist/cli.js rebuild-eventsnode dist/cli.js restore-excludednode dist/cli.js healthnode dist/cli.js status

أو عبر Docker:

bash
docker compose builddocker compose run --rm egypt-research node dist/cli.js seeddocker compose up -d

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

bash
npm run checknpm testnpm run test:coveragenpm run buildnpm run release:check

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

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

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

مشاريع مرسى الشقيقة · Sibling Marsa projects

المشروعما هوالرابط
Atlas MCP · أطلسمعلومات الخدمات والإحالة للهجرة واللجوء في مصر بمصادرها · service & referral information for migration and asylum in EgyptMCP: https://atlas.marsaplatform.com/mcp · GitHub
Malja MCP · ملجأبيانات إنسانية موثّقة (UNHCR، البنك الدولي، HDX، ReliefWeb) · trusted humanitarian open datahttps://spaces.marsaplatform.com/s/k3sb9ww3dj/
Marsa Spaces · مساحات مرسىنشر صفحات ثابتة بروابط عامة، مع خادم MCP لكل مساحة · static publishing with a per-space MCP serverhttps://spaces.marsaplatform.com · GitHub

كل المشاريع من مرسى. · All projects: https://marsaplatform.com/products.

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

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

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

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

Repository resources · موارد المستودع

Company container image

The maintained container is published under the company account and linked to marsaplatform/erx-mcp.

sh
docker pull ghcr.io/marsaplatform/erx-mcp:latest

Use the container-release workflow to publish the current source. latest tracks stable releases and manual snapshots; sha-… tags identify the source commit. The old personal-account packages have been removed; use the company installation URL above. Publishing does not change repository visibility.

Versioned updates

See container releases and migration for numbered versions, automatic release publishing, runtime verification, and the updated company installation commands.

Source: README.md at commit a45385c

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.2.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declaredRequired10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts