npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

egypt-research-mcp

v0.17.0

Published

Source-grounded MCP server and research commons for Egyptian public affairs

Readme

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

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

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

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

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

ابدأ من واجهة البحث دون حساب. ويمكن للمطورين ووكلاء الذكاء الاصطناعي استخدام طبقة MCP وREST نفسها بعد ذلك.

| ما الذي يقدمه 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 | كيانات وأحداث وادعاءات | | توثيق API | /docs | المسارات وأمثلة الاستخدام | | MCP | /mcp | Streamable HTTP للوكلاء | | REST API | /api/v1 | تكاملات مستقرة وقابلة للقراءة | | الجاهزية | /readyz | فحص سلامة قاعدة البيانات | | المقاييس | /metrics | مقاييس Prometheus |

أدوات MCP

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

| الأداة | الوظيفة | |---|---| | search_egypt | بحث حسب النص ونوع المصدر والفترة | | hybrid_search | بحث نصي ودلالي مع تفسير الترتيب | | get_document | وثيقة كاملة مع بيانات الاستشهاد | | research_dossier | نتائج وخط زمني وكيانات وادعاءات في طلب واحد | | trace_claim | تتبع الادعاء إلى الأدلة التي أوردته | | compare_claims | تجميع الادعاءات المتشابهة ومقارنة المواقف |

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

| الأداة | الوظيفة | |---|---| | compare_sources | مقارنة التغطية حسب نوع المصدر | | build_timeline | بناء خط زمني موثق | | list_stories | قصص متقاربة مع تنوع الناشرين | | find_entities | الكيانات ومواضع ظهورها | | list_events | الأحداث المؤرخة ووثائقها | | get_daily_brief | مواد يوم محدد وتنوع مصادرها | | list_sources | عرض كتالوج المصادر التشغيلية | | get_source_profile | بيانات المصدر وصحة الجمع |

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

| الأداة | الوظيفة | |---|---| | list_live_datasets | كتالوج مجموعات البيانات العامة | | get_live_data | جلب مؤشر أو سجل حي مع بيانات المصدر | | compare_live_data | مقارنة سلاسل مع تنبيه اختلاف المنهجيات | | live_source_health | فحص صحة موفري البيانات الحية | | export_references | تصدير RIS وBibTeX وCSV وJSONL | | get_coverage | تغطية الأرشيف وصحة المصادر | | 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 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.