nigeria-grid3-boundaries

Nigeria MCP — AI エージェント向けのナイジェリアのデータ

Wycord の製品で、Braynex Services Ltd. が開発しています。 作成者：Samuel Orie。ライセンス：MIT。

AI エージェント（Claude、Cursor、カスタムエージェント）向けに、整形・正規化されたナイジェリアのビジネスおよび地域データを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 register	不要

• 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から、ナイジェリアのUN SDG指標（貧困、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 年にナイジェリアの原油輸出先として上位だった国はどこですか？」または「現在のドルからナイラへの為替レートはいくらですか？」*と尋ねます。

認証情報が必要なサーバーも、同じ方法で認証情報を受け取ります。無料の Paystack キーについては lanes/bank-account/README.md を、無料の VTpass キーについては lanes/electricity/README.md をご覧ください。キーを設定しない場合、この 2 つのサーバーは組み込みのサンプルデータを提供します。その場合、すべての結果の先頭に [MOCK DATA: ...] テキストブロックが付き、_meta.dataSource = "mock" が設定されます。テストやオフライン作業のために、任意のサーバーでサンプルデータを強制的に使用するには、プロバイダー変数に mock を設定します。たとえば、FX_PROVIDER=mock とします。

設定

.env ファイルは読み込まれません。デフォルトを変更する必要がある場合にのみ、MCP クライアントの env ブロック（またはシェル）で変数を設定してください。どのサーバーも、これらの変数を設定しなくても動作します。その場合、認証情報が必要な 2 つのサーバーは、サンプルデータであることを明記したデータを提供します。

変数	サーバー	デフォルト	説明
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	3 つのキーがすべて設定されていれば vtpass、それ以外は mock	mock はサンプルデータ（明記あり）を強制します
VTPASS_API_KEY、VTPASS_PUBLIC_KEY、VTPASS_SECRET_KEY	Electricity Meter	未設定	VTpass のキー（無料）です。3 つすべて設定するとライブデータが有効になります
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" が設定されます。また、サーバーの起動時に標準エラー出力へ警告が表示されます。

外部接続先ホスト。 すべてのリクエストは 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	なし（オフライン）

掲載先

• Official MCP Registry — 全 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>/	データソースごとに 1 つの MCP サーバー — ライブアダプター（npx でのデフォルト）、オプトインの mock プロバイダー、ツール、スモークテスト／ライブテスト。
eval/	サーバー横断の評価ハーネス（npm run eval）。

ツールがプロバイダーを直接呼び出すことはありません。型付きインターフェースに依存するため、プロバイダーの選択は環境変数 1 つで行え、新しいプロバイダーの追加も 1 ファイルで済みます。すべてのリクエストは、User-Agent wycord-nigeria-mcp/<version> (+https://wycord.com) を使って識別され、各サーバーは serverInfo で実際のパッケージバージョンを報告します。ID データ（アカウント名、電力メーターの顧客詳細）は受け渡しのみで、キャッシュもログ記録もされません。API キーはヘッダーで送信され、URL には含まれません。

セキュリティ

脆弱性は非公開で報告してください。SECURITY.md をご覧ください。公開の Issue は作成しないでください。

---

© 2026 Braynex Services Ltd — MIT ライセンス（LICENSE および NOTICE を参照）。「Braynex Services Ltd」と製品名は、Braynex Services Ltd の商標です。