Bnm MCP

🚀 💹💹 BNM-MCP 📊📊

このプロジェクトは、マレーシア中央銀行（Bank Negara Malaysia, BNM）のOpen APIに接続するためのモデルコンテキストプロトコル（MCP）サーバーです。様々な金融データ（為替レート、基準金利、金価格など）をBNMから取得するツールを提供します。

📄 免責事項

このMCPサーバーはBNMと関係がなく、BNMによって承認されたものでもありません。このサーバーはBNMのOpenAPIエンドポイントを利用しており、BNMのAPIの一部のみを含んでいます。

✨ 主な機能

🪙 為替レートと通貨

• get_exchange_rate - クアラルンプールの銀行間外国為替市場の通貨為替レートを取得します。選択された国の通貨の価格は、マレーシアリンギットに対して表示されます。
• get_usd_myr_intraday_rate - 最新のUSD/MYR（米ドル - マレーシアリンギット）銀行間日中の最高および最低為替レートを取得します。レートは、商業銀行による米ドル対マレーシアリンギットの銀行間最高および最低取引レートから取得されます。
• get_usd_myr_reference_rate - 国内金融機関によって取引された銀行間USD/MYR外国為替スポットレートの加重平均ボリュームに基づいて計算され、毎日午後3:30に公開される最新の基準レートを取得します。
• get_daily_FX_turnover - 銀行間および顧客取引を含むすべての通貨の日次外国為替取引量を取得します。

🪙 金利

• get_base_rate - マレーシアの金融機関が提供する小売ローンまたは融資施設の現在の基準金利または基準貸出金利、および標準的な住宅ローン/住宅融資の目安有効貸出金利を取得します。
• get_overnight_policy_rate - 金融政策委員会によって決定されたオーバーナイト政策金利（OPR）を取得します。
• get_malaysia_overnight_rate_i - マレーシア中央銀行からマレーシアのオーバーナイトレートを取得します。
• get_islamic_interbank_rate - 様々な期間のイスラム銀行間預金レートの日次加重平均を取得します。
• get_interest_rates_banking_institution - 銀行機関別の金利を取得します。

🪙 通貨と銀行

• get_reserve_money - マレーシア中央銀行による最新の準備通貨データを取得します。
• get_currency_circulation_by_denomination - 以下の額面別の流通通貨を取得します。
  • 硬貨: 1セント、5セント、10セント、20セント、50セント、1リンギット
  • 紙幣: 1リンギット、5リンギット、10リンギット、20リンギット、50リンギット、100リンギット
• get_monetary_aggregates_M1_M2_M3 - マレーシア中央銀行による通貨統計M1、M2、およびM3のデータを取得します。
• get_broad_money_M3 - マレーシア中央銀行による広義通貨M3のデータを取得します。
• get_bnm_statement_assets - マレーシア中央銀行の資産明細書を取得します。
• get_banking_system_statement_assets - 銀行システムの資産明細書を取得します。利用可能な銀行機関のタイプ: 商業銀行、イスラム銀行、投資銀行、合計。

🪙 市場データ

• get_interbank_swap - 期間別の日次銀行間スワップボリュームを取得します。
• get_kijang_emas - マレーシアの金貨の日次取引価格を取得します。
• get_malaysian_government_securities_market_indicative_yield - マレーシア中央銀行からマレーシア政府証券市場の目安利回りを取得します。
• get_volume_transaction_interbank_money_market - マレーシア中央銀行から銀行間金融市場の取引ボリュームを取得します。
• get_volume_transaction_kl_foreign_exchange_market - マレーシア中央銀行からクアラルンプール外国為替市場の銀行間取引ボリュームを取得します。
• get_bond_market_highlights - 債券市場の市場ハイライトを取得します。

🪙 政府と経済

• get_federal_government_finance - 連邦政府の財政データを取得します。
• get_external_reserves - マレーシア中央銀行から対外準備の情報を取得します。
• get_labour_market_indicators_financial_services_sector - マレーシア中央銀行から金融サービスセクターの労働市場指標を取得します。

🪙 消費者保護

• get_financial_consumer_alert - BNMが管理する関連法令に基づいて承認されていない会社およびウェブサイトのリストを取得します。

🪙 イスラム金融

• get_takaful_key_indicators - マレーシア中央銀行からタカフルの主要指標を取得します。

📦 インストール

必要条件

• Python >=3.11
• MCP SDK 1.2.0以上
• uvパッケージマネージャー

uvパッケージマネージャーのインストール

方法1: pipを使用する（ほとんどのユーザーに推奨）

pip install uv

方法2: Unixシステム（Linux、macOS）の場合

curl -LsSf https://astral.sh/uv/install.sh | sh

🚀 クイックスタート

1. このリポジトリをクローンします。

git clone https://github.com/meisin/bnm-mcp.git

2. 依存関係をインストールします。

uv sync

3. MCPサーバーを起動します。

uv run main.py

サーバーが起動し、MCPインターフェースを介してツールが公開されます。

💻 Claude Desktopへの接続

1. 公式ウェブサイトからClaude Desktopをインストールします。
2. Claude Desktopを設定して、あなたのMCPサーバーを使用するようにします。

{
    "mcpServers": {
        "mcp-server": {
            "command": "uv",  # uvコマンドの絶対パスを使用することをおすすめします
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/YOUR/bnm-mcp",
                "run",
                "main.py"
            ]
        }
    }
}

📄 ライセンス

このプロジェクトは研究および教育目的です。データの使用ポリシーについては、マレーシア中央銀行のAPI利用規約を参照してください。