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 服務器時請務必小心，因為它會讀取你的敏感數據，如賬戶餘額和交易記錄。請確保僅在受信任的應用程序和環境中使用。