IL Bank MCP 🐷💸

概要

IL Bank MCP は、イスラエルの銀行データをあらゆる AI アシスタントで利用できる金融アシスタントです。ヘッドレススクレーパー（israeli-bank-scrapers を使用）と MCP サーバーを組み合わせ、LLM が取引を分析し、支出パターンを追跡して、金融に関するインサイトを提供できるようにします。

✨ デモ

IL Bank MCP の使い方

手早くセットアップするには、Docker Compose で実行します。

LEUMI_USERNAME=my_user LEUMI_PASSWORD=my_pass ... \
  docker compose up -d

次に、AI アシスタントに追加します。Raycast の場合は、MCP 拡張機能で以下を使用します。

docker compose -f /path/to/il-bank-mcp/docker-compose.yml run --rm -i mcp-server

Claude Desktop の場合は、~/.claude/config.jsonc に追加します。

{
  "mcpServers": {
    "israeli-bank-assistant": {
      "command": "docker",
      "args": [
        "compose",
        "-f",
        "/path/to/il-bank-mcp/docker-compose.yml",
        "run",
        "--rm",
        "-i",
        "mcp-server"
      ],
      "env": {
        "LEUMI_USERNAME": "your_username",
        "LEUMI_PASSWORD": "your_password"
      }
    }
  }
}

すべての認証情報と設定オプションについては、env.example をご覧ください。

IL Bank MCP の主な機能

• スマート分析：支出の内訳を確認し、定期的な請求を検出して、加盟店の利用パターンを追跡します
• ローカルで安全：すべてのデータはローカルの SQLite データベースに保存されます
• 複数プロバイダー対応：イスラエルのほとんどの銀行やクレジットカードで利用できます
• リアルタイム更新：任意のプロバイダーから必要に応じてデータを更新できます
• オンデマンド同期：新しいインサイトが必要なときに、いつでも銀行データをスクレイピングできます

どのような質問ができますか？

金融データからインサイトを得るための質問例を紹介します。

• 「Wolt の支出パターンを分析して」
• 「支払っているサブスクリプションと、その月額合計をすべて表示して」
• 「過去 30 日間の ₪1,000 を超える取引を、カテゴリとともにすべて表示して」
• 「先月、食料品にいくら使った？」
• 「今月と先月の支出を比較して」

IL Bank MCP が提供するツール

• get_transactions - 任意の期間の取引を取得します
• get_financial_summary - 収入、支出、傾向をひと目で確認します
• search_transactions - 金額や説明から特定の取引を検索します
• get_monthly_credit_summary - クレジットカード利用状況の内訳を表示します
• get_recurring_charges - サブスクリプションや繰り返しの支払いを検索します
• analyze_merchant_spending - 通常とは異なる支出パターンを見つけます
• refresh_all_data - 接続済みのすべてのアカウントのデータを更新します
• get_scrape_status - データの最終更新日時を確認します

IL Bank MCP のよくある質問

対応している銀行はどこですか？
israeli-bank-scrapers が対応している銀行です。Leumi、Hapoalim、Discount、そしてほとんどのクレジットカード会社が含まれます。

データは安全ですか？
はい。すべてお使いのマシン上でローカルに実行されます。データがコンピューターの外部に送信されることはありません。

ローカル LLM で使えますか？
もちろんです。Raycast 経由で Ollama と連携でき、完全にオフラインの環境で快適に利用できます。

スクレイピングに失敗した場合はどうすればよいですか？
./logs のログを確認してください。多くの問題はログインに関するものです。認証情報が銀行のウェブサイトで使用しているものと完全に一致しているか確認してください。

コントリビューション

まだ初期段階です。コントリビューションを歓迎します！🙏

ライセンス

MIT

謝辞

• israeli-bank-scrapers - 中核となるスクレイピングエンジン
• Model Context Protocol - MCP フレームワーク