mbbank-mcp

🚀 MBBank MCP Server

MBBank MCP 服务器助力 MBBank API 实现交易和余额的监控与分析，为用户提供高效的数据洞察。

🚀 快速开始

🔍 环境要求

• uv
• Python 3.10 或更高版本

💻 使用方式

在 Claude Desktop 中安装

按照 MCP 安装 指南 操作，并使用以下配置：

⚠️ 重要提示

请将 <your_username> 和 <your_password> 替换为你实际的 MB 银行凭证。请勿将用户名和密码设置为 env 变量，否则会导致 Python 运行时出错。

{
    "mcpServers": {
        "mbbank": {
            "command": "uvx",
            "args": [
                "mbbank-mcp",
                "--username=<your_username>",
                "--password=<your_password>"
            ]
        }
    }
}

若使用 Docker，可使用以下配置：

{
    "mcpServers": {
        "mbbank": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "MBBANK_USERNAME",
                "-e",
                "MBBANK_PASSWORD",
                "thedtvn/mbbank-lib:latest"
            ],
            "env": {
                "MBBANK_USERNAME": "<your_username>",
                "MBBANK_PASSWORD": "<your_password>"
            }
        }
    }
}

独立运行 MCP 服务器

若要独立运行 MCP 服务器，可添加 --sse 标志以启用 SSE 模式（默认是标准输入输出模式）。

--username 和 --password 标志是可选的，你也可以将它们设置为环境变量 MBBANK_USERNAME 和 MBBANK_PASSWORD。

你可以使用 --host 和 --port 标志指定服务器地址（默认：localhost:3000）。

uvx mbbank-mcp --username=<your_username> --password=<your_password> --host=localhost --port=3000 --sse 

🛠️ 工具介绍

get_balances

获取 MB 银行所有账户的余额。

get_today_date

以 YYYY-MM-DD 格式返回当前日期。当模型无法访问实时时钟时，此工具对交易处理很有用。

get_transactions

获取 MB 银行指定账户在给定日期范围内的交易记录。

参数：

• account_number（字符串）：要获取交易记录的账户号码
• from_date（字符串）：交易记录的开始日期，格式为 dd-mm-yyyy
• to_date（字符串）：交易记录的结束日期，格式为 dd-mm-yyyy

get_cards

获取 MB 银行的银行卡信息。

get_card_transactions

获取 MB 银行指定银行卡的交易记录。

参数：

• card_id（字符串）：要获取交易记录的银行卡 ID，可通过 get_cards 工具获取
• from_date（字符串）：交易记录的开始日期，格式为 dd-mm-yyyy
• to_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 服务器时请务必小心，因为它会读取你的敏感数据，如账户余额和交易记录。请确保仅在受信任的应用程序和环境中使用。