Egypt Research Commons

ERX — Egypt Research Commons

关注埃及公共事务。回到源头。· 关注埃及公共事务。回到源头。

面向研究人员和记者的埃及新闻、公共记录与数据搜索引擎及档案库。
搜索埃及新闻、公共记录和数据，每条结果均关联其来源。

网站 · 搜索 · 文档 · 品牌 · 架构

本地截图拍摄于 2026 年 10 月 24 日，使用随附的来源目录，未导入任何文档。截图中的数字属于此演示版本，并非托管服务的统计数据。

检查结果已按日期记录在审查报告中。

搜索埃及，而非噪声

ERX 面向从埃及公共事务相关问题开始研究的研究人员和记者，例如政府决策、经济指标、立法、人权议题、公共服务，或不同来源对同一新闻的报道方式。它汇集新闻、官方和法律文档、学术资料及公共数据，并将每条结果与原始链接、发布日期、出现背景及排序理由关联起来。

ERX 不是媒体机构，也不会代替研究人员判断主张是否属实。它是一个可审查的研究空间，帮助你从问题 → 来源 → 证据 → 引用逐步推进。

可以搜索哪些内容？

领域	实际示例
政治与经济	追踪政府决策、比较报道，并将其与预算或公共指标关联
法律与人权	查找原始法律、判决或声明，并追踪议题的发展
社会与公共服务	通过新闻和数据搜索卫生、教育、就业与人口相关内容
媒体与公共话语	比较不同时期的标题、立场和出版方多样性

无需账号即可从搜索界面开始使用。开发人员和 AI Agent 之后也可以使用同一套 MCP 和 REST 层——配合 Python 和 TypeScript 客户端库、使用指南、固定的引用 ID，以及用于导出可引用档案副本的 dataset-dump 命令。

ERX 提供什么？	如何确保可审查？
阿拉伯语全文和语义搜索	为每条结果清晰说明排序理由
报道与主张比较	提供文档链接、出版方和日期
时间线、实体与事件	区分事件日期、发布日期和归档日期
实时公共数据	提供许可证、抓取时间和原始链接
RIS、BibTeX、CSV 和 JSONL 导出	迁移参考文献时保留来源

一分钟内开始使用

• 在浏览器中：搜索界面无需账号即可使用。
• 用于你的 AI Agent（MCP）或 REST：托管版本需要免费密钥：在入门页面登记电子邮件，从订阅者面板创建密钥（仅显示一次），然后在 Authorization: Bearer <key> 请求头中发送（或使用 X-API-Key）。免费方案每月 50,000 次调用。自托管无需密钥。

托管 MCP 端点（Streamable HTTP）：

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

Claude Code

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"）：

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

Claude Desktop（claude_desktop_config.json，通过 mcp-remote）：

{
  "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 或更高版本）：

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

你可以试着问问你的 Agent：“追踪上个月燃油价格上调决策的报道，并列出来源”，或“比较官方和新闻来源如何报道新《劳动法》，并以 BibTeX 格式导出参考文献”。

英文快速入门

ERX（Egypt Research Commons）是面向埃及公共事务、以来源为依据的研究档案库和 MCP 服务：包含 35 个可运行的数据源、21 个只读 egypt_* MCP 工具，并且每条结果都关联其原始 URL、发布方和日期。

• 网页搜索： https://egypt-research.marsaplatform.com/explore — 开放使用，无需账户。
• 托管 MCP： https://egypt-research.marsaplatform.com/mcp 和 REST …/api/v1 需要免费 API 密钥（在 https://egypt-research.marsaplatform.com/#signup 注册，在控制面板中创建密钥，并发送 Authorization: Bearer <key>）。免费套餐：每月 50,000 次调用。
• 自托管（无需密钥）： npx -y egypt-research-mcp serve --transport stdio（Node ≥ 24）。
• Claude Code、Claude Desktop、Cursor 和 VS Code 的连接配置示例见上文及 docs/USAGE.md。健康检查：/health · 状态：/status.html · API 文档：/docs。

可用界面

界面	路径	用途
主页	/	产品介绍和档案库状态
研究者界面	/explore	无需账户即可进行阿拉伯语搜索，并提供引导式查询示例
知识图谱	/knowledge	实体、事件和主张
关于我们	/about	使命、方法论和运营方
隐私	/privacy	我们不会记录或追踪的内容
研究者安全	/safety	研究敏感主题的指南
API 文档	/docs	路径和使用示例，以及安装代码片段
MCP	/mcp	面向 Agent 的 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 资源，以及用于结构化研究和主张核验的提示词。完整的执行定义请参阅 src/mcp.ts。

工作原理

• ERX 从 35 个官方、法律、学术、统计、人权和新闻运营来源收集数据。已关闭或停止运营的来源不会显示在运营目录中。
• 遵守 robots.txt，并为每个来源分别设置延迟，以及大小和页面数量限制。
• 提取 HTML 和 PDF；缺少文本层时，使用资源占用有限的阿拉伯语 OCR。
• 文档内容变化时保留文档版本，并为每次收集操作留存记录。
• 从搜索结果中排除体育、娱乐和与埃及无关的国际新闻，同时将其保留在档案中供审核。
• 使用 SQLite FTS5 和可解释的本地语义表示，并可选择通过 GEMINI_API_KEY 使用 Gemini Embeddings。

详情：架构 · 运维 · 威胁模型。

本地开发

需要 Node.js 24 或更高版本以及 npm。

git clone https://github.com/marsaplatform/erx-mcp.git
cd erx-mcp
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 restore-excluded
node dist/cli.js health
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 镜像。请参阅 发布检查清单和当前审查报告。

方法局限

• ERX 不会自动为来源评定真实性等级。
• 同一说法反复出现，不代表经过了独立核实。
• 对报道进行聚类只是基于文本相似度的辅助功能，并非编辑判断。
• 原始链接始终是最终参考依据。
• 代码采用 MIT 许可；已索引材料的权利仍归其所有者所有。

مرسى 旗下姊妹项目 · Sibling Marsa projects

项目	简介	链接
Atlas MCP · أطلس	埃及移民与庇护服务及转介信息，附带来源 · 埃及移民与庇护服务和转介信息	MCP: https://atlas.marsaplatform.com/mcp · GitHub
Malja MCP · ملجأ	经核实的人道主义数据（UNHCR、世界银行、HDX、ReliefWeb）· 可信的人道主义开放数据	https://spaces.marsaplatform.com/s/k3sb9ww3dj/
Marsa Spaces · مساحات مرسى	发布带有公开链接的静态页面，每个空间配有 MCP 服务 · 静态发布，每个空间配备 MCP 服务	https://spaces.marsaplatform.com · GitHub

所有项目均来自 مرسى。· 所有项目：https://marsaplatform.com/products。

品牌与贡献

品牌指南介绍品牌、颜色、语气以及徽标的正确用法。参与贡献请参阅 CONTRIBUTING.md 和 CODE_OF_CONDUCT.md。如需报告安全问题，请使用 SECURITY.md。

提问。比较。引用。

仓库资源 · Repository resources

• 许可证 / الترخيص

公司容器镜像

维护中的容器镜像由公司账号发布，并关联至 marsaplatform/erx-mcp。

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

使用 container-release 工作流发布当前源代码。 latest 指向稳定版本和手动快照；sha-… 标签用于标识源代码提交。旧的个人账号软件包已被移除；请使用上方的公司安装 URL。发布不会改变仓库的可见性。

版本更新

请参阅容器版本与迁移，了解编号版本、自动发布、运行时验证，以及更新后的公司安装命令。