Bnm MCP

🚀 BNM-MCP

BNM-MCP 是一個模型上下文協議（MCP）服務器，用於連接馬來西亞國家銀行（BNM）的 開放 API。該項目提供了從 BNM 獲取各種金融數據的工具，如匯率、基準利率、黃金價格等。

🚀 快速開始

安裝依賴

安裝 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

啟動 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"
            ]
        }
    }
}

✨ 主要特性

本項目提供了一系列工具，可從 BNM 獲取各類金融數據，涵蓋匯率、利率、貨幣與銀行、市場數據、政府與經濟、消費者保護以及伊斯蘭金融等多個領域。

匯率與貨幣 🪙

• get_exchange_rate：獲取吉隆坡銀行間外匯市場的貨幣匯率，所選國家貨幣價格以馬來西亞林吉特報價。
• get_usd_myr_intraday_rate：獲取最新的美元/林吉特（USD/MYR）銀行間日內最高和最低匯率，該匯率來自商業銀行交易的美元兌林吉特銀行間最高和最低成交價。
• get_usd_myr_reference_rate：獲取最新參考匯率，該匯率基於國內金融機構交易的銀行間美元/林吉特外匯即期匯率的加權平均交易量計算得出，每日下午 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：獲取未獲得馬來西亞國家銀行相關法律法規授權或批准的公司和網站列表。

伊斯蘭金融 🪙

• get_takaful_key_indicators：獲取馬來西亞國家銀行的回教保險關鍵指標。

📦 安裝指南

環境要求

• Python >=3.11
• MCP SDK 1.2.0 或更高版本
• uv 包管理器

安裝步驟

1. 安裝 uv 包管理器
   • 方法 1：使用 pip（推薦大多數用戶）

pip install uv

- **方法 2：Unix 系統（Linux、macOS）**

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

2. 克隆倉庫並安裝依賴

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

📄 許可證

本項目僅用於研究和教育目的。有關數據使用政策，請參考馬來西亞國家銀行的 API 使用條款。

⚠️ 重要提示

本 MCP 服務器與馬來西亞國家銀行（BNM）無關聯，也未得到 BNM 的認可；該服務器利用了 BNM 的開放 API 端點，僅包含 BNM API 的一部分。