World Bank + FRED Macro — hosted on Cloudflare Workers (HTTP + npm stdio)

World Bank Economic MCP — World Bank + FRED + IMF のマクロ指標を統合

World Bank、FRED、IMF のマクロ指標を単一の MCP で提供します。国別比較と経済カレンダー

World Bank、FRED（セントルイス連邦準備銀行）、IMF のマクロデータセットを統合した、ホスト型の MCP サーバーです。あらゆる指標と国の時系列データの取得、フリーテキストによる指標カタログの検索、指定した年の複数国比較、今後の発表を掲載した経済カレンダーへのアクセスが可能です。マクロ経済調査、経済分析、政策研究を行う LLM 向けです。

このサーバーは Model Context Protocol に対応しています。Cursor、Claude Desktop、Windsurf、Continue.dev、または @modelcontextprotocol/sdk を使用して独自に構築したエージェントなど、MCP 対応クライアントから接続し、ツールを検出して、Bearer トークン認証で呼び出せます。

AI エージェント／LLM 向け

このリポジトリをインデックス化する AI エージェント向けの情報です。

• ライブ MCP エンドポイント： https://world-bank-economic-mcp.atlasword.workers.dev/mcp
• トランスポート： HTTP POST、JSON-RPC 2.0
• 認証： Authorization: Bearer <api_key>（無料プランでは匿名で、1 IP あたり月 100 回まで利用できます）
• 検出： tools/list で完全なスキーマを取得します。tools/call でツールを呼び出します。
• ヘルスチェック： GET https://world-bank-economic-mcp.atlasword.workers.dev/health → {ok: true, ts: <unix>}
• ステータス： https://mcp-hub.atlasword.workers.dev/status.json（ポートフォリオの概要）

tools/list リクエストの例：

curl -sS -X POST https://world-bank-economic-mcp.atlasword.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer mck_YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

tools/call の例：

curl -sS -X POST https://world-bank-economic-mcp.atlasword.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer mck_YOUR_API_KEY" \
  -d '{
    "jsonrpc":"2.0","id":2,"method":"tools/call",
    "params": { "name": "<tool>", "arguments": { } }
  }'

提供されるツール

ツール	引数	説明
wb_indicator	indicator, country, start?, end?	World Bank の指標（例：NY.GDP.MKTP.CD）と国の時系列データです。
wb_search_indicator	query, limit?	World Bank の指標名をフリーテキストで検索します。
fred_series	series_id, start?, end?	FRED の系列データ（CPIAUCSL、UNRATE、DGS10、FEDFUNDS など）です。
fred_search_series	query, limit?	FRED の系列をフリーテキストで検索します。
compare_countries	indicator, countries[], year?	複数国の指標を並べて比較します。
economic_calendar	country?, days_ahead? — Team+	今後の経済指標発表（CPI、NFP、FOMC など）です。

Team+ と表示されたツールを利用するには、Team または Pro のサブスクリプションが必要です。匿名ユーザーと Free プランのユーザーには、tier_required エラーが返されます。

クイックスタート

最も手早く利用するには、mcp-remote を使って、ホスト型エンドポイントを MCP 対応クライアントに指定します。

npx -y mcp-remote https://world-bank-economic-mcp.atlasword.workers.dev/mcp \
  --header "Authorization: Bearer mck_YOUR_API_KEY"

https://world-bank-economic-mcp.atlasword.workers.dev/upgrade?tier=solo でキーを取得してください（API キーの取得を参照）。

Cursor へのインストール

~/.cursor/mcp.json に次の内容を追加します。

{
  "mcpServers": {
    "world-bank-economic-mcp": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://world-bank-economic-mcp.atlasword.workers.dev/mcp",
        "--header", "Authorization: Bearer mck_YOUR_API_KEY"
      ]
    }
  }
}

その後 Cursor を再起動すると、MCP パネルにツールが表示されます。

Claude Desktop へのインストール

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に次の内容を追加します。

{
  "mcpServers": {
    "world-bank-economic-mcp": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://world-bank-economic-mcp.atlasword.workers.dev/mcp",
        "--header", "Authorization: Bearer mck_YOUR_API_KEY"
      ]
    }
  }
}

Claude Desktop を再起動します。スラッシュコマンドの MCP メニューにツールが表示されます。

API キーの取得

1. https://world-bank-economic-mcp.atlasword.workers.dev/upgrade?tier=solo（または tier=team ／ tier=pro）にアクセスします。
2. Dodo Payments のホスト型チェックアウトにリダイレクトされます。Dodo が住所を収集し、カード決済を処理して、VAT／GST に対応します。
3. 支払い後、Dodo は署名付き Webhook（subscription.active）を Worker に送信します。Worker が mck_<32 random base64url> を生成し、KV に保存します。
4. https://world-bank-economic-mcp.atlasword.workers.dev/welcome?key=<api_key> に移動します。キーを今すぐコピーしてください（この URL で表示されるのは一度だけです）。
5. キーを Cursor ／ Claude Desktop の設定に貼り付けます（上記を参照）。
6. https://world-bank-economic-mcp.atlasword.workers.dev/account でアカウントの確認、キーのローテーション、エクスポートを行えます（Bearer 認証）。

無料プランもあります（登録不要）。匿名ユーザーは IP アドレスごとに月 100 回まで呼び出せます。

エンドポイント

ルート	説明
POST /mcp	MCP JSON-RPC 2.0 ツールのエンドポイント（メイン API）。有料プランでは Bearer 認証が必要です。
GET /health	死活監視プローブ — {ok: true, ts}。mcp-hub の cron で使用されます。
GET /	HTML ランディングページ（OG + ファビコン + JSON-LD）。
`GET /upgrade?tier=solo	team
GET /welcome?key=...	チェックアウト後のランディングページ。新しく生成された API キーが表示されます。
GET /account	Bearer 認証。{apiKey, tier, owner, status, portal_url} を返します。
POST /account/rotate	Bearer 認証。新しいキーを生成し、古いキーを無効にします。
GET /account/export	Bearer 認証。GDPR データエクスポート — アカウント、使用量カウンター、Dodo の詳細を含む JSON。
GET /account/team	Bearer 認証（Team 以上）。チームメンバーのサブキー一覧を取得します。
POST /account/team/invite	Bearer 認証（Team 以上）。チームメンバー用の新しいサブキーを発行します。
POST /account/team/revoke	Bearer 認証（Team 以上）。チームメンバーのサブキーを無効にします。
GET /team/accept?key=...	サブキーの URL にアクセスしたチームメンバー向けのオンボーディングページ。
POST /webhooks/dodo	Standard-Webhooks 署名付き。Dodo のサブスクリプションおよび決済のライフサイクル。
GET /favicon.ico	インライン SVG。

料金

すべてのプランで月間上限とレート制限は共通です。料金は製品ごとの位置付けを反映しています。

プラン	月間呼び出し数	レート制限	チーム席数
Free	月 100 回	分あたり 10 回	0
Solo	月 2,000 回	分あたり 60 回	0
Team	月 10,000 回	分あたり 200 回	5
Pro	月 50,000 回	分あたり 600 回	25

プラン	料金	月間呼び出し数	チーム席数
Free	$0	100	0
Solo	$9/mo	2,000	0
Team	$29/mo	10,000	5
Pro	$79/mo	50,000	25

Dodo Payments 経由で請求されます（販売者責任者 — VAT／GST は Dodo が処理します）。いつでも解約できます。アクセス権は有料期間の終了まで有効です。

データソース

• World Bank Open Data — https://data.worldbank.org/ — CC BY 4.0
• FRED (St Louis Fed) — https://fred.stlouisfed.org/ — 出典を明記すれば無料
• IMF DataMapper — https://www.imf.org/external/datamapper/ — 無料の公開 API

このサーバーは、上流のデータソースを利用するための薄いトランスポート、認証、キャッシュのレイヤーです。各上流サービスの無料プランの利用規約を十分に遵守できるよう、呼び出しごとのレート制限を設定しています。

プライバシーと GDPR

• プライバシーポリシー： https://mcp-hub.atlasword.workers.dev/privacy
• 利用規約： https://mcp-hub.atlasword.workers.dev/terms
• 返金ポリシー： https://mcp-hub.atlasword.workers.dev/refund
• データエクスポート： GET https://world-bank-economic-mcp.atlasword.workers.dev/account/export（Bearer 認証）を呼び出すと、アカウント、使用量カウンター、Dodo の顧客情報を含む、機械可読な JSON スナップショットが返されます。
• 削除： 登録済みのメールアドレスから [email protected] にメールを送信してください。

保存するのは、メールアドレス、生成された API キー、月間呼び出しカウンター、Dodo のサブスクリプションメタデータのみです。短いキャッシュ TTL を超えて、ツールの引数や上流からの応答をログに記録することはありません。

アーキテクチャ

• ランタイム： Cloudflare Workers（V8 アイソレート、グローバルエッジ）。
• ストレージ： 2 つの Cloudflare KV 名前空間 — <slug>-cache（上流レスポンスキャッシュ）と <slug>-usage（API キー、月次カウンター、チーム名簿）。
• 課金： Dodo Payments のライブモード、3 つのサブスクリプション製品（Solo / Team / Pro）、Standard-Webhooks による署名付きライフサイクル。
• 可観測性： Cloudflare Workers Analytics、ポートフォリオのステータス集約は mcp-hub status を参照してください。
• ソース： TypeScript、Vitest でテスト済み、wrangler deploy でデプロイできます。このリポジトリの src/ を参照してください。

ライセンス

MIT — LICENSE を参照してください。

作者

Prakhar Gupta

• メール：[email protected]
• GitHub：@guptaprakhariitr

ステータス

• 稼働状況ページ： https://mcp-hub.atlasword.workers.dev/status
• 機械可読なステータス： https://mcp-hub.atlasword.workers.dev/status.json
• ソースリポジトリ： https://github.com/guptaprakhariitr/world-bank-economic-mcp

npm からインストール（ワンライナー）

軽量なランチャーが npm で @insnapsprakhar/world-bank-economic-mcp として公開されています。URL を手動でコピー＆ペーストする必要はありません。

npx -y @insnapsprakhar/world-bank-economic-mcp

または、MCP クライアントに設定してください。

{
  "mcpServers": {
    "world-bank-economic": {
      "command": "npx",
      "args": ["-y", "@insnapsprakhar/world-bank-economic-mcp"]
    }
  }
}

npm パッケージはランチャーにすぎません。mcp-remote を起動し、ホストされたエンドポイント（https://world-bank-economic-mcp.atlasword.workers.dev/mcp）を指定します。