Mbbank MCP

🚀 MBBank MCP Server

MBBank API用のMCPサーバーで、取引や残高の監視と分析を支援します。

📦 インストール

必要条件

• uv
• Python 3.10以上

Claude Desktopでのインストール

MCPのインストールガイドに従い、以下の設定を使用します。

⚠️ 重要提示

<your_username> と <your_password> を実際のMB Bankの認証情報に置き換えてください。 ユーザー名とパスワードの 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 (string): 取引を取得する口座番号
• from_date (string): 取引の開始日付（dd-mm-yyyy形式）
• to_date (string): 取引の終了日付（dd-mm-yyyy形式）

get_cards

MB Bankのカード情報を取得します。

get_card_transactions

MB Bankの特定のカードの取引を取得します。

パラメーター:

• card_id (string): 取引を取得するカードID。get_cards ツールから取得します。
• from_date (string): 取引の開始日付（dd-mm-yyyy形式）
• to_date (string): 取引の終了日付（dd-mm-yyyy形式）

get_savings

MB Bankの貯蓄口座情報を取得します。

get_saving_details

MB Bankの特定の貯蓄口座の詳細を取得します。

パラメーター:

• account_number (string): 詳細を取得する貯蓄口座のID。get_savings ツールから取得します。
• account_type (Literal["OSA", "SBA"]): 口座のタイプ。オンライン貯蓄口座の場合は "OSA"、貯蓄銀行口座の場合は "SBA"。

get_interest_rates

MB Bankの貯蓄口座の金利を取得します。

パラメーター:

• currency (Literal["VND", "USD", "EUR"]): 金利を取得する通貨

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については LICENSE ファイルを参照してください。

📚 よくある質問

このMCPサーバーは無料で使用できますか？

はい、このMCPサーバーは無料で使用できます。

このMCPサーバーは安全に使用できますか？

はい、このMCPのコアは mbbank-lib です。FAQ を確認できます。

このMCPサーバーで送金や引き出しはできますか？

いいえ、このMCPサーバーは送金や引き出しをサポートしていません。残高や取引の確認など、監視と分析目的のみに設計されています。

ただし、このMCPサーバーを使用する際は注意が必要です。口座残高や取引などの機密データを読み取るため、信頼できるアプリケーションや環境でのみ使用するようにしてください。