Nbu Ua

mcp-nbu-ua

ウクライナ国立銀行（NBU）の公開統計 MCP。キー不要です。

Pipeworx の一部です。AI エージェントを1683以上の稼働中データソースに接続するMCPゲートウェイです。

ツール

ツール	説明
nbu_exchange_rates	1日分の全通貨に対するNBUの公式為替レート（ウクライナ国立銀行が毎日設定するレート）です。通貨ごとに1件のレコードを返します：{r030（数値の通貨コード）、txt（ウクライナ語名）、rate（通貨1単位あたりのUAH）、cc（ISO-4217コード。例：USD/EUR/PLN）、exchangedate（DD.MM.YYYY）}。今日のレートを取得する場合は、dateを省略します。
nbu_currency_rate	1日の単一通貨に対するNBUの公式レートです。valcodeにはISO-4217コード（例：USD、EUR、GBP）を指定します。rateはその通貨1単位あたりのUAHです。今日のレートを取得する場合は、dateを省略します。日付範囲における1通貨の時系列データを取得する場合は、代わりにnbu_currency_historyを使用します。
nbu_currency_history	日付範囲における単一通貨のNBU公式レートの日次時系列データです。valcode（ISO-4217。例：USD）と、YYYYMMDD形式のstart／endを指定します。営業日ごとに1件のレコードを返します：{exchangedate（DD.MM.YYYY）、cc、txt（ウクライナ語名）、enname（英語名）、rate（unitsあたりのUAH）、units、rate_per_unit}。期間内の全通貨を取得する場合は、valcodeを省略します。新しい順に並びます。
nbu_monetary_aggregates	指定した月のNBUの通貨供給量（M0、M1、M2、M3。単位は100万UAH）です。各レコード：{dt（YYYYMMDD）、txt（ウクライナ語名）、txten（英語名）、id_api（例：M2/M3）、value、freq}。dateで対象月を選択します（その月の任意の日を指定できます）。省略すると、最新の利用可能な月が対象になります。
nbu_international_reserves	指定した月のNBUの公式国際（準備）資産を、構成要素別に分類したデータです。各レコード：{dt（YYYYMMDD）、txt（ウクライナ語名）、txten（英語名）、id_api、value、freq}。dateで対象月を選択します。省略すると、最新の利用可能な月が対象になります。

クイックスタート

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

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

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

https://gateway.pipeworx.io/nbu-ua/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も、同じゲートウェイと1683以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworxを使ってすべてのツールにアクセスできます。

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

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

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

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

このパッケージは、ローカルの stdio MCP サーバーとしても動作します。Pipeworx アカウントも、ゲートウェイへの往復通信も不要です：

{
  "mcpServers": {
    "nbu-ua": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-nbu-ua"]
    }
  }
}

または、起動を確認するために直接実行します：

npx -y @pipeworx/mcp-nbu-ua

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

ask_pipeworx での使用

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

ask_pipeworx({ question: "your question about Nbu Ua data" })

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

詳細

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

ライセンス

MIT