nigeria-worldbank-macro

Nigeria MCP — 面向 AI Agent 的尼日利亚数据

由 Braynex Services Ltd. 打造的 Wycord 产品。 作者：Samuel Orie。许可证：MIT。

向 AI Agent（Claude、Cursor、自定义 Agent）提供经过清理和规范化的尼日利亚商业及本地数据，形式为 MCP 工具——每个数据源对应一个服务，各自通过类型化的提供方接口接入。

状态：12 个服务已在 npm 和官方 MCP Registry 上线。所有服务默认返回实时数据——无需设置环境变量。10 个服务无需密钥；Bank Resolve 和 Electricity Meter 在设置免费密钥后会使用实时数据。未设置密钥时，它们会提供内置示例数据，且每条此类结果都会标注为 [MOCK DATA]，避免与真实数据混淆。（admin-divisions 完全离线运行，使用捆绑的数据集——它没有实时数据源。）

---

产品

服务端	npm	工具	实时数据源	需要密钥？
Trade Intel	@wycord/nigeria-mcp-trade-intel	get_trade_stats · classify_hs	UN Comtrade	无
FX Rates	@wycord/nigeria-mcp-fx-rates	get_fx_rates	open.er-api.com	无
Bank Resolve	@wycord/nigeria-mcp-bank-account	resolve_bank_account · list_banks	Paystack	免费密钥
Electricity Meter	@wycord/nigeria-mcp-electricity	validate_meter · list_discos	VTpass（只读）	免费密钥
Admin Boundaries	@wycord/nigeria-mcp-grid3-boundaries	get_boundary · point_in_admin	GRID3 ArcGIS（CC BY 4.0）	无
Admin Divisions	@wycord/nigeria-mcp-admin-divisions	list_states · get_lgas	内置数据集（离线）	无
Health Facilities	@wycord/nigeria-mcp-health-facility	find_facilities_near · get_facility	GRID3 NGA Health Facilities v2.0（CC BY 4.0）	无
World Bank Macro	@wycord/nigeria-mcp-worldbank-macro	get_macro_indicator	World Bank Indicators API	无
IMF WEO	@wycord/nigeria-mcp-imf-weo	get_imf_projection	IMF DataMapper API	无
UN SDG	@wycord/nigeria-mcp-un-sdg	get_sdg_indicator	UN SDG Global Database	无
Crypto Tickers	@wycord/nigeria-mcp-quidax-crypto	get_crypto_ticker · list_crypto_markets	Quidax（只读）	无
Sanctions Screening	@wycord/nigeria-mcp-nigsac-sanctions	screen_sanctions	NIGSAC 登记册	无

• Trade Intel — 按合作伙伴、商品和年份统计尼日利亚进出口数据，支持年度或月度统计，包含美元金额（以及 CIF/FOB）、净重和数量，以及商品明细。还支持 HS 编码分类。
• FX Rates — 尼日利亚奈拉兑美元、欧元和英镑的实时汇率。
• Bank Resolve — 根据 10 位 NUBAN 和银行代码查询已登记的账户名称；列出银行及其代码。
• Electricity Meter — 只读电表验证（客户姓名／地址及 DisCo）和 DisCo 列表。不支持付款。
• Admin Boundaries — 尼日利亚行政边界（州／LGA／区）：质心、边界框，以及将经纬度点反向地理编码为包含该点的行政单位。数据来自 GRID3 ArcGIS，无需密钥。
• Admin Divisions — 尼日利亚 36 个州、FCT 及全部 774 个 LGA。使用内置数据集完全离线运行，无需网络或密钥。
• Health Facilities — 查找尼日利亚某个地点附近的医疗机构，按距离排序，并查询单个机构的详细信息。数据来自 GRID3 NGA Health Facilities v2.0，无需密钥。
• World Bank Macro — 通过 World Bank Indicators API 获取尼日利亚宏观指标（GDP、通胀、人口、汇款、FDI、失业率）。无需密钥。
• IMF WEO — 通过 IMF DataMapper API 获取 IMF 对尼日利亚的《世界经济展望》预测（增长、通胀、债务、经常账户、失业率）。无需密钥。
• UN SDG — 通过 UN SDG Global Database 获取尼日利亚的联合国可持续发展目标指标（贫困、5 岁以下儿童死亡率、电力和饮水获取、初等教育完成率）。无需密钥。
• Crypto Tickers — 尼日利亚奈拉计价的实时加密货币行情（BTC/NGN 等），只读，另提供可交易市场列表。使用 Quidax 公共 API，无需密钥。
• Sanctions Screening — 根据尼日利亚官方 NIGSAC 制裁登记册筛查姓名。结果是供人工审核的尽力模糊筛查信号，并非法律／合规认定，且仅涵盖尼日利亚名单。无需密钥。

每个服务端的 README 均包含完整的工具文档、示例和可直接复制粘贴的配置：请参阅 lanes/<server>/README.md。 实际应用场景：USE_CASES.md。

安装

一键安装（Claude Desktop）

从最新版本下载安装包并双击即可。无需终端，无需克隆——安装包包含运行所需的一切；需要密钥的服务端会在安装过程中提示输入免费 API 密钥（留空则提供带有标注的示例数据）。

或通过 npx（任意 MCP 客户端）

无需克隆（Node.js ≥ 20）。添加到 MCP 配置中：

{
  "mcpServers": {
    "nigeria-trade-intel": {
      "command": "npx",
      "args": ["-y", "@wycord/nigeria-mcp-trade-intel"]   // live data, no key, no env
    },
    "nigeria-fx-rates": {
      "command": "npx",
      "args": ["-y", "@wycord/nigeria-mcp-fx-rates"]      // live data, no key, no env
    }
  }
}

然后询问："2023 年尼日利亚原油出口的主要贸易伙伴有哪些？" 或 "现在美元兑奈拉的汇率是多少？"

需要密钥的服务以相同方式获取凭据——请参阅 lanes/bank-account/README.md（免费的 Paystack 密钥）和 lanes/electricity/README.md（免费的 VTpass 密钥）。没有密钥时，这两个服务会提供内置示例数据，每条结果都会以 [MOCK DATA: ...] 文本块开头，并附带 _meta.dataSource = "mock"。如需在任何服务上强制使用示例数据（用于测试或离线工作），请将其 provider 变量设为 mock，例如 FX_PROVIDER=mock。

配置

不会读取 .env 文件。仅当需要更改默认值时，才在 MCP 客户端的 env 块（或 shell）中设置变量。所有服务在不设置这些变量时都能正常工作；此时，两个需要密钥的服务会提供带标签的示例数据。

变量	服务	默认值	作用
FX_PROVIDER	FX Rates	free	free = 实时数据；mock = 带标签的示例数据
TRADE_PROVIDER	Trade Intel	opendata	opendata = UN Comtrade 实时数据；mock = 带标签的示例数据
BOUNDARY_PROVIDER	Admin Boundaries	grid3	grid3 = 实时数据；mock = 带标签的示例数据
HEALTH_PROVIDER	Health Facilities	grid3	grid3 = 实时数据；mock = 带标签的示例数据
MACRO_PROVIDER	World Bank Macro	worldbank	worldbank = 实时数据；mock = 带标签的示例数据
IMF_PROVIDER	IMF WEO	imf	imf = 实时数据；mock = 带标签的示例数据
SDG_PROVIDER	UN SDG	unsdg	unsdg = 实时数据；mock = 带标签的示例数据
CRYPTO_PROVIDER	Crypto Tickers	quidax	quidax = 实时数据；mock = 带标签的示例数据
SANCTIONS_PROVIDER	Sanctions Screening	nigsac	nigsac = 实时名录；mock = 带标签的合成数据占位内容
ADMIN_DIVISIONS_PROVIDER	Admin Divisions	static	唯一可用值。内置数据集，无网络请求
BANK_PROVIDER	Bank Resolve	如果设置了密钥则为 paystack，否则为 mock	mock 强制使用带标签的示例数据
PAYSTACK_SECRET_KEY	Bank Resolve	未设置	Paystack 密钥（免费）。启用实时数据
ELECTRICITY_PROVIDER	Electricity Meter	如果设置了全部三个密钥则为 vtpass，否则为 mock	mock 强制使用带标签的示例数据
VTPASS_API_KEY、VTPASS_PUBLIC_KEY、VTPASS_SECRET_KEY	Electricity Meter	未设置	VTpass 密钥（免费）。全部三个密钥均可启用实时数据
VTPASS_BASE_URL	Electricity Meter	https://sandbox.vtpass.com/api	生产环境使用 https://vtpass.com/api
GRID3_STATE_URL、GRID3_LGA_URL、GRID3_WARD_URL	Admin Boundaries	GRID3 图层	覆盖图层 URL
GRID3_HEALTH_URL	Health Facilities	GRID3 图层	覆盖图层查询 URL
UN_SDG_BASE_URL	UN SDG	https://unstats.un.org/sdgapi	覆盖 API 基础 URL
NIGSAC_LIST_URL	Sanctions Screening	https://nigsac.gov.ng/IndSancList	覆盖名单 URL

模拟结果不会静默返回：每条工具结果都会以 [MOCK DATA: ...] 文本块开头，并附带 _meta.dataSource = "mock"；服务启动时还会在 stderr 中打印警告。

出站主机。 每个请求都通过 https 发往服务声明的主机。若 URL 覆盖项（*_URL 变量）指向其他主机，请求发出前会被拒绝。

服务	主机
FX Rates	open.er-api.com
Trade Intel	comtradeapi.un.org
Bank Resolve	api.paystack.co
Electricity Meter	vtpass.com、sandbox.vtpass.com
Admin Boundaries、Health Facilities	services3.arcgis.com
World Bank Macro	api.worldbank.org
IMF WEO	www.imf.org
UN SDG	unstats.un.org
Crypto Tickers	app.quidax.io
Sanctions Screening	nigsac.gov.ng
Admin Divisions	无（离线）

查找位置

• 官方 MCP 注册表 — 全部 12 个服务（同名服务的新版本），io.github.wycord/nigeria-{trade-intel,fx-rates,bank-resolve,electricity,grid3-boundaries,admin-divisions,health-facility,worldbank-macro,imf-weo,un-sdg,quidax-crypto,nigsac-sanctions}
• Smithery — @braynexservices/nigeria-fx-rates · trade-intel · bank-resolve · electricity（目前，12 个服务中有 4 个已在 Smithery 上架；其余 8 个较新的服务尚未上架）
• Glama — glama.ai/mcp/servers/wycord/nigeria-mcp
• npm — @braynexservices

从源代码构建

npm install
npm run build      # core first, then each server (npm workspaces)
npm run verify     # build + smokes + cross-server eval — runs on the mock providers, so no network and no signup

工作原理

路径	说明
shared/	核心库 — buildServer、规范化的 Zod 架构、类型化的提供方接口、fetchJson（超时 + 随机抖动重试）、缓存与错误辅助函数。
lanes/<server>/	每个数据源对应一个 MCP 服务 — 实时适配器（通过 npx 使用的默认选项）、可选的 mock 提供方、工具以及冒烟测试／实时测试。
eval/	跨服务评估工具（npm run eval）。

工具不会直接调用提供方：它们依赖类型化接口，因此选择提供方只需设置一个环境变量，添加提供方只需一个文件。每个请求都会通过 User-Agent wycord-nigeria-mcp/<version> (+https://wycord.com) 标识自身，并且每个服务都会在 serverInfo 中报告实际的软件包版本。身份数据（账户名称、电表客户详情）仅透传 — 从不缓存，从不记录日志；API 密钥通过标头传递，绝不会放在 URL 中。

安全

请私下报告漏洞 — 详见 SECURITY.md。请勿公开提交 issue。

---

© 2026 Braynex Services Ltd — 采用 MIT 许可证（参见 LICENSE 和 NOTICE）。“Braynex Services Ltd”及产品名称均为 Braynex Services Ltd 的商标。