MBBank MCP Server

用于MBBank API的MCP服务器，帮助监控和分析交易及余额。

要求

• uv
• Python 3.10或更高版本

使用方法

在Claude Desktop中安装

请遵循MCP安装指南，使用以下配置：

注意
请用您的实际MB Bank凭证替换<your_username>和<your_password>。
您不应设置用户名和密码的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模式（默认为stdio模式）。

--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 Bank中所有账户的余额。

get_today_date

返回当前日期，格式为YYYY-MM-DD。在模型无法访问实时时钟的情况下处理交易时很有用。

get_transactions

获取给定日期MB Bank账户中的交易记录。

参数：

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

get_cards

获取MB Bank中的卡片信息。

get_card_transactions

获取MB Bank中特定卡片的交易记录。

参数：

• card_id (字符串)：要获取交易记录的卡片ID。可以从get_cards工具中获得
• from_date (字符串)：交易开始日期，格式为dd-mm-yyyy
• to_date (字符串)：交易结束日期，格式为dd-mm-yyyy

get_savings

获取MB Bank中的储蓄账户信息。

get_saving_details

获取MB Bank中特定储蓄账户的详细信息。

参数：

• account_number (字符串)：要获取详细信息的储蓄账户ID。可以从get_savings工具中获得
• account_type (字面量["OSA", "SBA"])：账户类型，"OSA"表示在线储蓄账户，"SBA"表示储蓄银行账户

get_interest_rates

获取MB Bank中储蓄账户的利率。

参数：

• currency (字面量["VND", "USD", "EUR"])：要获取利率的货币

许可证

本项目采用MIT许可证。详情请参阅LICENSE文件。

常见问题解答

这个MCP服务器可以免费使用吗？

是的，这个MCP服务器可以免费使用。

这个MCP安全吗？

是的，这个MCP核心是mbbank-lib，您可以查看FAQ了解更多信息。

这个MCP服务器可以转账或取款吗？

不可以，此MCP服务器不支持转账或取款操作。它仅设计用于监控和分析目的，例如检查余额和交易记录。

然而，在使用此MCP服务器时应谨慎，因为它会读取您的敏感数据，如账户余额和交易记录。确保仅在可信的应用程序和环境中使用它。