Back to Browse
About
Source-grounded research for Egyptian public affairs
Remote endpoints: streamable-http: https://erx-mcp.zad.tools/mcp
Security Report
4.8
Use Caution4.8High RiskERX is a well-structured Arabic research commons MCP server with solid security practices. The codebase demonstrates proper input validation, safe credential handling, and appropriate permission scoping. Minor code quality observations exist around broad error handling and logging practices, but no security vulnerabilities were identified. Permissions align with the server's stated purpose of aggregating and serving research data. Supply chain analysis found 5 known vulnerabilities in dependencies (1 critical, 1 high severity). Package verification found 1 issue.
4 files analyzed · 9 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
How to Install & Connect
Available as Local & Remote
This plugin can run on your machine or connect to a hosted endpoint. during install.
Documentation
View on GitHubFrom the project's GitHub README.
ERX — Egypt Research Commons
كل معلومة لها مصدر. بحث عربي موثّق للشأن المصري للباحثين والصحفيين ووكلاء AI.
التشغيل · أدوات MCP · النشر · الهوية · خطة التسويق
Production: erx-mcp.zad.tools ·
MCP: https://erx-mcp.zad.tools/mcp
الإمكانات الحالية
- كتالوج من 33 مصدرًا رسميًا وقانونيًا وأكاديميًا وإحصائيًا وإخباريًا وحقوقيًا.
- 29 مصدرًا بقنوات جمع مباشرة: 18 RSS وSitemap واحدة و13 موصل HTML و3 واجهات API رسمية؛ منها 6 مصادر متعددة القنوات، دون الاعتماد على Google News.
- تدقيق حي للمصادر الـ33 يختبر XML وروابط المقالات وسجلات JSON، ويميز الحجب و429 والتحويلات غير المتوافقة.
- استخراج HTML وPDF، مع طبقة النص أولًا ثم OCR عربي محدود الموارد عند الحاجة.
- احترام
robots.txtوسياسة تأخير مستقلة لكل مصدر وحدود للحجم والصفحات. - أرشفة إصدارات الوثائق عند تغير محتواها.
- تجميع التغطيات المتشابهة في قصص مع إظهار عدد الوثائق وتنوع المصادر.
- سجل لكل عملية جمع، بما فيها الفشل والمدة وعدد المواد.
- بحث عربي هجين يجمع SQLite FTS5 وتمثيلًا دلاليًا محليًا قابلًا للتفسير.
- دعم اختياري لـ Gemini Embeddings عبر
GEMINI_API_KEY. - استخراج كيانات وأحداث وادعاءات منسوبة وربطها بالأدلة الأصلية.
- تصنيف موضوعي عربي قابل للمراجعة.
- روابط واستشهادات أصلية مع تاريخ النشر والأرشفة.
- تصدير CSV وJSONL وBibTeX وRIS.
- واجهة عربية RTL تعمل دون حساب مستخدم.
- Streamable HTTP للاستخدام البعيد وstdio للاستخدام المحلي.
- REST API مستقرة تحت
/api/v1مع وصف OpenAPI. - 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 | بحث نصي ودلالي مع سبب ترتيب كل نتيجة |
find_entities | الكيانات المستخرجة وعدد الوثائق والظهور |
list_events | الأحداث المؤرخة ووثائقها الأصلية |
trace_claim | تتبع الادعاء إلى كل دليل ومصدر أورده |
save_research_query | حفظ استعلام متابعة محلي؛ معطلة في نقطة 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 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، وحالة الجاهزية: /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:
- حزمة عامة على npm.
- تسجيل رسمي في MCP Registry باسم
io.github.ahmedvnabil/egypt-research. - صورة متعددة المعماريات على GitHub Container Registry.
يُنشر الموقع وStreamable HTTP على erx-mcp.zad.tools، بينما ينشر إنشاء tag
الحزمة العامة وبيانات MCP Registry وGitHub Release تلقائيًا.
npm run release:check
git tag v0.7.0
git push origin v0.7.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 وبوابة موثوقة وتحديد معدل موزع عند تشغيل عدة نسخ عامة.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
80.0K
Stars
7
Installs
6.5
Security
No ratings yet
Local
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
137
Stars
544
Installs
8.0
Security
4.8
Local
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
-
Stars
82
Installs
10.0
Security
4.6
Local