Hnb Hr について
Hnb Hr は、クロアチア国立銀行の為替レートを提供する MCP サーバーです。ユーロ基準の通貨データを扱う AI エージェント向けに、全通貨の照会や単一通貨の最新・過去レート検索を提供します。
主な機能
- 01指定日の全外貨レート検索
- 02単一通貨の対ユーロレート取得
- 03最新または過去レートの照会
- 04期間内の日次レート取得
活用シーン
- 01外貨の対ユーロ基準レートの確認
- 02通貨の過去レート推移の確認
MCP 対応
クロアチア国立銀行の為替レート検索ツールを MCP クライアントに提供します。Pipeworx ゲートウェイ経由、またはローカルの stdio MCP サーバーとして利用できます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://gateway.pipeworx.io/hnb-hr/mcpclaude mcp add --transport http pipeworx-io-hnb-hr https://gateway.pipeworx.io/hnb-hr/mcp{"mcpServers":{"pipeworx-io-hnb-hr":{"type":"http","url":"https://gateway.pipeworx.io/hnb-hr/mcp"}}}Cursor で開く{"servers":{"pipeworx-io-hnb-hr":{"type":"http","url":"https://gateway.pipeworx.io/hnb-hr/mcp"}}}VS Code で開く{"mcpServers":{"pipeworx-io-hnb-hr":{"type":"http","url":"https://gateway.pipeworx.io/hnb-hr/mcp"}}}{"mcpServers":{"pipeworx-io-hnb-hr":{"serverUrl":"https://gateway.pipeworx.io/hnb-hr/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
mcp-hnb-hr
クロアチア国立銀行(Hrvatska narodna banka、HNB)の為替レート MCP。キー不要です。
Pipeworx の一部です。AI エージェントを1881以上のライブデータソースに接続する MCP ゲートウェイです。独立した非公式の統合であり、上流プロバイダーとは提携、承認、公開のいずれもされていません。
ツール
| ツール | 説明 |
|---|---|
hnb_exchange_rates | 指定日の全外国通貨を対象とした、HNB(クロアチア国立銀行)の公式為替レートです。クロアチアはユーロ圏に属しているため、すべてのレートはユーロに対する値(1 EUR あたりの外貨単位数)として表示されます。valuta(3文字の ISO コード)、srednji_tecaj(中値/参考レート)、kupovni_tecaj(買値)、prodajni_tecaj(売値)、datum_primjene(適用日)の各行を返します。最新の適用レートを取得する場合は、date を省略してください。レート値は小数点の区切りにカンマを使用した文字列です(例:"1,164900")。 |
hnb_currency_rate | EUR に対する、指定した1種類の外国通貨の HNB 為替レートです(クロアチアはユーロ圏に属しています)。3文字の ISO 通貨コード(例:"USD"、"GBP"、"CHF")を指定します。3つのモードがあります。最新レートを取得するには日付を省略します。単一の過去日付を指定するには date を渡します。その期間の日次時系列を取得するには start_date と end_date を渡します。srednji_tecaj は中値/参考レートです。レート値は小数点の区切りにカンマを使用した文字列です(例:"1,164900")。日付の形式は YYYY-MM-DD です。 |
クイックスタート
MCP クライアント(Claude Desktop、Cursor、Windsurf など)に追加します:
{
"mcpServers": {
"hnb-hr": {
"url": "https://gateway.pipeworx.io/hnb-hr/mcp"
}
}
}
このエンドポイントが実際に提供するもの
https://gateway.pipeworx.io/hnb-hr/mcp の tools/list は、上の表にあるツールに加えて、Pipeworx 共通のメタツールである ask_pipeworx、
discover_tools、search_within、remember/recall など、ゲートウェイ全体で使えるツール一式も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック固有のツールと並んで、およそ30個の共通ツールが表示されます。接続時の initialize レスポンスには正確な範囲が記載されており、その日の状況を確認するための正式な情報源です。
これは意図的な設計であり、偶然の多重化ではありません。メタツールを使うことで、このパックが対応していない質問にも、カタログ全体を横断してルーティングする ask_pipeworx を通じて回答できます。そのため、MCP サーバーをもう1つ追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマがもたらすコンテキストコストがルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。
このパックのツールだけでなく、すべてのパックのツールを直接一覧表示するには、Pipeworx フルゲートウェイに接続してください:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
どちらの URL も同じゲートウェイと、同じ1881以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらから接続しても、ask_pipeworx を通じてすべてのツールを利用できます。
MCP クライアントがない場合:HTTP で呼び出す
curl -X POST https://gateway.pipeworx.io/v1/tools/hnb_exchange_rates \
-H 'Content-Type: application/json' \
-d '{}'
最初の呼び出しにアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/hnb_exchange_rates を使用します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用します。
スタンドアロン(ゲートウェイアカウント不要)
このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントは不要で、ゲートウェイを経由する必要もありません:
{
"mcpServers": {
"hnb-hr": {
"command": "npx",
"args": ["-y", "@pipeworx/mcp-hnb-hr"]
}
}
}
または、直接実行して起動を確認します:
npx -y @pipeworx/mcp-hnb-hr
stdin/stdout 経由で MCP を使用し、initialize/tools/list/tools/call に対して、このパックのツールのみを返します。上記のゲートウェイ接続で追加される共通メタツールは含まれません。同じデータソース、同じツールで、ask_pipeworx によるルーティングはありません。
ask_pipeworx の使用
ツールを直接呼び出す代わりに、自然な英語で質問できます。この方法は、上記のパックエンドポイントとフルゲートウェイのどちらでも使えます:
ask_pipeworx({ question: "your question about Hnb Hr data" })
ゲートウェイが適切なツールを選び、引数を自動的に設定します。
詳細情報
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。