Hkma Hk について
Hkma Hkは、香港金融管理局の公開データセットにキーなしでアクセスでき、金融・通貨統計の利用者に適しています。任意のエンドポイントパスからデータを取得できるほか、流動性、通貨供給量、HIBOR、HKD為替レートの専用ツールを備えています。
主な機能
- 01エンドポイントパスで公開HKMAデータを取得
- 02日次の銀行間流動性データを取得
- 03通貨供給量の構成項目を取得
- 04期間と日付範囲を指定してHIBORを照会
- 05主要通貨に対するHKDレートを取得
活用シーン
- 01専用ツールにないHKMA系列を調査
- 02日次HIBORと銀行間流動性を追跡
- 03通貨供給量の構成項目を時系列で確認
- 04日付別にHKD為替レートを確認
MCP 対応
HKMAデータセット取得と専用照会ツールをMCPクライアントに公開します。Pipeworxゲートウェイ経由または単独のstdio MCPサーバーとして利用できます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://gateway.pipeworx.io/hkma-hk/mcpclaude mcp add --transport http pipeworx-io-hkma-hk https://gateway.pipeworx.io/hkma-hk/mcp{"mcpServers":{"pipeworx-io-hkma-hk":{"type":"http","url":"https://gateway.pipeworx.io/hkma-hk/mcp"}}}Cursor で開く{"servers":{"pipeworx-io-hkma-hk":{"type":"http","url":"https://gateway.pipeworx.io/hkma-hk/mcp"}}}VS Code で開く{"mcpServers":{"pipeworx-io-hkma-hk":{"type":"http","url":"https://gateway.pipeworx.io/hkma-hk/mcp"}}}{"mcpServers":{"pipeworx-io-hkma-hk":{"serverUrl":"https://gateway.pipeworx.io/hkma-hk/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
mcp-hkma-hk
香港金融管理局(HKMA)の公開オープン API MCP です。キーは不要です。
Pipeworx の一部です。AI エージェントを1881以上のライブデータソースに接続する MCP ゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携しておらず、承認も公開もされていません。
ツール
| ツール | 説明 |
|---|---|
hkma_dataset | エンドポイントのパス(https://api.hkma.gov.hk/public/ の後の部分)を指定して、任意の HKMA 公開データセットを取得します。共通形式のレスポンスを返します。データ行は result.records の下に、合計数は result.datasize に格納されます。便利なツールでカバーされていない HKMA の系列を取得する場合に使用してください。検証済みのパス例:「market-data-and-statistics/daily-monetary-statistics/daily-figures-interbank-liquidity」(日次 HIBOR/総残高/TWI)、「market-data-and-statistics/daily-monetary-statistics/daily-figures-monetary-base」(マネタリーベースの構成項目)、「market-data-and-statistics/monthly-statistical-bulletin/er-ir/hk-interbank-ir-daily」(期間別の HIBOR 固定値)、「market-data-and-statistics/monthly-statistical-bulletin/er-ir/er-eeri-daily」(主要通貨に対する HKD 為替レート)、「market-data-and-statistics/monthly-statistical-bulletin/er-ir/hkd-fer-daily」(HKD のフォワードポイント)、「market-data-and-statistics/monthly-statistical-bulletin/er-ir/composite-ir」(総合金利、月次)、「market-data-and-statistics/monthly-statistical-bulletin/banking/customer-deposits-by-currency」、「coin-cart-schedule」(lang が必要)。詳細は apidocs.hkma.gov.hk で確認できます。日付の形式は YYYY-MM-DD です。offset/pagesize でページネーションできます。 |
hkma_interbank_liquidity | 銀行間流動性の日次データです。オーバーナイトおよび1か月物の HIBOR、総残高(始値/終値)、ディスカウント・ウィンドウの基準金利、兌換保証の強側/弱側レート(7.75/7.85)、実効為替レート指数(TWI)が含まれます。営業日ごとに1レコードがあり、最新のものから順に並びます。日付範囲を指定するには from/to を使用してください。 |
hkma_monetary_base | 香港マネタリーベースの構成項目の日次データです。負債証明書、流通している政府紙幣および硬貨、総残高(ディスカウント・ウィンドウの前後)、発行残高のある為替基金証券および為替基金債が含まれます。営業日ごとに1レコードです。日付範囲を指定するには from/to を使用してください。 |
hkma_interbank_interest_rates | 期間別の HKD 銀行間取引金利(HIBOR)です。オーバーナイト、1週間、1/3/6/9/12か月物が含まれ、日ごと(end_of_day)に1レコードあります。データソースは Monthly Statistical Bulletin の er-ir 系列です。日付範囲を指定するには from/to を使用してください。 |
hkma_exchange_rates | 主要通貨(USD、GBP、JPY、CNY、EUR、AUD、CAD、SGD など)に対する HKD の市場為替レートです。日ごと(end_of_day)に1レコードあります。データソースは Monthly Statistical Bulletin の er-ir er-eeri-daily 系列です。日付範囲を指定するには from/to を使用してください。 |
クイックスタート
MCP クライアント(Claude Desktop、Cursor、Windsurf など)に追加します。
{
"mcpServers": {
"hkma-hk": {
"url": "https://gateway.pipeworx.io/hkma-hk/mcp"
}
}
}
このエンドポイントが実際に提供するもの
https://gateway.pipeworx.io/hkma-hk/mcp の tools/list は、上の表にあるツールに加えて、共有 Pipeworx メタツール(ask_pipeworx、discover_tools、search_within、remember/recall など、ゲートウェイ全体で利用できる一連のツール)も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック固有のツールとともに、共有ツールが約 30 個表示されます。接続の initialize レスポンスに正確な範囲が記載されており、その日の状況を確認する際の正式な情報源となります。
これは意図的な設計であり、誤って多重化されているわけではありません。メタツールを使えば、このパックが扱わない質問にも、カタログ全体を対象にルーティングする ask_pipeworx を通じて回答できます。MCP サーバーをもう 1 つ追加する必要はありません。現時点では、メタツールなしでパックエンドポイントをマウントする方法はありません。追加のスキーマによって増えるコンテキストがルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに 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/hkma_dataset \
-H 'Content-Type: application/json' \
-d '{"path":"market-data-and-statistics/daily-monetary-statistics/daily-figures-interbank-liquidity"}'
最初の呼び出しにアカウントは必要ありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/hkma_dataset を実行します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。
スタンドアロン(ゲートウェイアカウント不要)
このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントは不要で、ゲートウェイとの往復通信もありません。
{
"mcpServers": {
"hkma-hk": {
"command": "npx",
"args": ["-y", "@pipeworx/mcp-hkma-hk"]
}
}
}
または、直接実行して起動を確認できます。
npx -y @pipeworx/mcp-hkma-hk
stdin/stdout 経由で MCP を使用し、このパックのツールのみについて、initialize/tools/list/tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。
ask_pipeworx を使用する
ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックエンドポイントでも、フルゲートウェイでも利用できます。
ask_pipeworx({ question: "your question about Hkma Hk data" })
ゲートウェイが適切なツールを選び、引数を自動的に設定します。
詳細
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。