🚀 MBBank MCP Server
MBBank MCP 服务器助力 MBBank API 实现交易和余额的监控与分析，为用户提供高效的数据洞察。
🚀 快速开始
🔍 环境要求
- uv
- Python 3.10 或更高版本
💻 使用方式
在 Claude Desktop 中安装
按照 MCP 安装 指南 操作，并使用以下配置：
⚠️ 重要提示
请将
和替换为你实际的 MB 银行凭证。请勿将用户名和密码设置为env变量，否则会导致 Python 运行时出错。
{
"mcpServers": {
"mbbank": {
"command": "uvx",
"args": [
"mbbank-mcp",
"--username=" ,
"--password="
]
}
}
}
若使用 Docker，可使用以下配置：
{
"mcpServers": {
"mbbank": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MBBANK_USERNAME",
"-e",
"MBBANK_PASSWORD",
"thedtvn/mbbank-lib:latest"
],
"env": {
"MBBANK_USERNAME": "" ,
"MBBANK_PASSWORD": ""
}
}
}
}
独立运行 MCP 服务器
若要独立运行 MCP 服务器，可添加 --sse 标志以启用 SSE 模式（默认是标准输入输出模式）。
--username 和 --password 标志是可选的，你也可以将它们设置为环境变量 MBBANK_USERNAME 和 MBBANK_PASSWORD。
你可以使用 --host 和 --port 标志指定服务器地址（默认：localhost:3000）。
uvx mbbank-mcp --username= --password= --host=localhost --port=3000 --sse
🛠️ 工具介绍
get_balances
获取 MB 银行所有账户的余额。
get_today_date
以 YYYY-MM-DD 格式返回当前日期。当模型无法访问实时时钟时，此工具对交易处理很有用。
get_transactions
获取 MB 银行指定账户在给定日期范围内的交易记录。
参数：
account_number（字符串）：要获取交易记录的账户号码from_date（字符串）：交易记录的开始日期，格式为 dd-mm-yyyyto_date（字符串）：交易记录的结束日期，格式为 dd-mm-yyyy
get_cards
获取 MB 银行的银行卡信息。
get_card_transactions
获取 MB 银行指定银行卡的交易记录。
参数：
card_id（字符串）：要获取交易记录的银行卡 ID，可通过get_cards工具获取from_date（字符串）：交易记录的开始日期，格式为 dd-mm-yyyyto_date（字符串）：交易记录的结束日期，格式为 dd-mm-yyyy
get_savings
获取 MB 银行的储蓄账户信息。
get_saving_details
获取 MB 银行指定储蓄账户的详细信息。
参数：
account_number（字符串）：要获取详细信息的储蓄账户 ID，可通过get_savings工具获取account_type（Literal["OSA", "SBA"]）：账户类型，"OSA" 表示在线储蓄账户，"SBA" 表示储蓄银行账户
get_interest_rates
获取 MB 银行储蓄账户的利率信息。
参数：
currency（Literal["VND", "USD", "EUR"]）：要获取利率的货币类型
📄 许可证
本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。
❓ 常见问题解答
这个 MCP 服务器可以免费使用吗？
是的，这个 MCP 服务器可以免费使用。
这个 MCP 服务器使用安全吗？
是的，此 MCP 的核心是 mbbank-lib，你可以查看 常见问题解答 了解详情。
这个 MCP 服务器可以进行转账或取款操作吗？
不，这个 MCP 服务器不支持转账或取款操作。它仅用于监控和分析目的，例如查询余额和交易记录。
⚠️ 重要提示
使用此 MCP 服务器时请务必小心，因为它会读取你的敏感数据，如账户余额和交易记录。请确保仅在受信任的应用程序和环境中使用。