Big Mac Index

@pipeworx/big-mac-index

The Economistのビッグマック指数です。約55か国におけるビッグマックの現地通貨およびドルでの価格と、各通貨がドル、ユーロ、ポンド、円、元に対してどの程度割高または割安かを、GDP一人当たりで調整した値と調整前の値で示します。2000年から最新の発表分までを網羅しており、年2回更新されます。

Pipeworxの一部です。1875以上のライブデータソースにAIエージェントを接続するMCPゲートウェイです。これは独立した非公式の統合であり、上流のプロバイダーとは提携、承認、公開の関係にありません。

ツール

• big_mac_index(country?, date?, history?, limit?)：指定した国の指数発表分（デフォルトは最新）のデータを返します。現地価格、対ドル為替レート、ドル建て価格、およびUSD、EUR、GBP、JPY、CNYに対する調整前とGDP調整後の評価額が含まれます。history: trueを指定すると、2000年以降の全発表分を取得できます。countryを省略すると、1回の発表分について全ての国が一覧表示されます。「ビッグマック指数ではスイスフランは割高ですか？」といった質問に答えます。
• big_mac_valuation(base_currency?, date?, adjusted?, limit?)：指定した基準通貨に対する各通貨の評価額を、割高な順に並べて返します。「ビッグマック指数で最も割安な通貨はどれですか？」といった質問に答えます。

評価額はパーセンテージです。+45.4は現地通貨が基準通貨に対して45.4％割高であることを意味し、-30は30％割安であることを意味します。日付引数（YYYY、YYYY-MM、またはYYYY-MM-DD）を指定すると、その日付以前で最も新しい発表分が選択されます。すべてのレスポンスにはdata_as_of（指数の最新発表日）、source、licenceが含まれます。指数に含まれていない国の場合は、found: falseと、対象国の一覧が返されます。

認証

不要です。

データソース

• The Economist、ビッグマック指数（big-mac-dataリポジトリ、完全版指数）：The Economistの計算による価格、為替レート、調整前およびGDP調整後の評価額。

ライセンス。 big-mac-dataリポジトリは、The Economist Newspaperの著作権で2018年にMIT Licenseのもと公開されています。「本ソフトウェアおよび関連ドキュメントファイルの複製を取得するすべての人に対し、ソフトウェアを無制限に取り扱う許可を無償で付与します。これには、使用、複製、変更、結合、公開、配布、サブライセンス、および販売の権利が含まれますが、これらに限定されません」。すべてのレスポンスに出典表示が含まれます。各呼び出しでは、リクエスト時点で公開されている指数を読み込みます。

次の担当者向けの注意事項：

• 国名はThe Economistの表記に従います。「United Kingdom」ではなく「Britain」、ユーロは「Euro area」（ISOコードEUZ）です。一般的な別名（UK、US、eurozone、UAE）はマッピングされます。
• GDP調整後の数値は、The EconomistがGDPデータを持つ国についてのみ公開されています。それ以外はnullです。
• 2012年以前の発表は不定期です（1月、4月、5月、6月、7月のいずれかに年1回または2回）。2012年以降は1月と7月に発表されます。2019年7月の発表のうち1件は9日付、2020年1月の発表のうち1件は14日付です。
• 出典データではベネズエラの通貨コードが変更されている（VEFからVESへ）ため、名前またはVENで照合してください。

クイックスタート

MCPクライアント（Claude Desktop、Cursor、Windsurfなど）に追加します：

{
  "mcpServers": {
    "big-mac-index": {
      "url": "https://gateway.pipeworx.io/big-mac-index/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/big-mac-index/mcp の tools/list は、上記の表にあるツールに加えて、共通の Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントでは、そのパック固有のツールに加えて、共通ツールがおよそ30個一覧に表示されます。接続の initialize レスポンスに正確な範囲が示されるため、その日の状況を確認する際の正式な情報源になります。

これは意図的な設計であり、偶発的な多重化ではありません。メタツールを使うと、このパックの対象外の質問にも、カタログ全体を横断する ask_pipeworx 経由で回答できます。そのため、2つ目の MCP サーバーを追加する必要はありません。現在、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費が、ルーティングのメリットを上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧に表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと同じ1875以上のデータソースにアクセスします。違いは、どのパックのツールが直接一覧に表示されるかだけです。ask_pipeworx を使えば、どちらからでもすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/big_mac_index \
  -H 'Content-Type: application/json' \
  -d '{"country":"Switzerland"}'

最初の呼び出しにアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/big_mac_index を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントは不要で、ゲートウェイとの往復通信もありません。

{
  "mcpServers": {
    "big-mac-index": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-big-mac-index"]
    }
  }
}

または、直接実行して起動することを確認できます。

npx -y @pipeworx/mcp-big-mac-index

stdin／stdout 経由で MCP を使用し、このパックのツールのみについて initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共通メタツールは含まれません。同じソース、同じツールですが、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは上記のパックエンドポイントとフルゲートウェイの両方で機能します。

ask_pipeworx({ question: "your question about Big Mac Index data" })

ゲートウェイが適切なツールを選択し、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT