🚀 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
克隆仓库并安装依赖
- 克隆此仓库：
git clone https://github.com/meisin/bnm-mcp.git
- 安装依赖：
uv sync
启动 MCP 服务器
uv run main.py
服务器将启动并通过 MCP 接口提供工具。
连接到 Claude Desktop
- 从官方网站安装 Claude Desktop。
- 配置 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包管理器
安装步骤
- 安装
uv包管理器- 方法 1：使用 pip（推荐大多数用户）
pip install uv
- **方法 2：Unix 系统（Linux、macOS）**
curl -LsSf https://astral.sh/uv/install.sh | sh
- 克隆仓库并安装依赖
git clone https://github.com/meisin/bnm-mcp.git
uv sync
📄 许可证
本项目仅用于研究和教育目的。有关数据使用政策，请参考马来西亚国家银行的 API 使用条款。
⚠️ 重要提示
本 MCP 服务器与马来西亚国家银行（BNM）无关联，也未得到 BNM 的认可；该服务器利用了 BNM 的开放 API 端点，仅包含 BNM API 的一部分。