Credit Card MCP Server Demo

This is a Model Context Protocol (MCP) server that provides tools for fetching and managing credit card transactions using the israeli-bank-scrapers library.

Features

• Fetch credit card transactions from Israeli banks (Demo shows a single provider scraping process)
• Store transactions in a local SQLite database
• Query stored transactions with filtering options
• Secure credential management

Installation

1. Clone the repository

2. Install dependencies:

npm install

Configuration

Chromium Path

The server requires Chromium for web scraping. You can configure the path to the Chromium executable in two ways:

1. Environment variable:

export CHROMIUM_PATH=/path/to/chromium

2. Default path:

The default path is set to `/opt/homebrew/bin/chromium`. You can modify this in `src/config.ts`.

Usage

1. Build the project:

npm run build

2. Start the server:

npm start

Available Tools

1. Scrape Transactions

Fetch transactions from your bank:

{
  "name": "scrapeTransactions",
  "arguments": {
    "credentials": {
      "username": "your_username",
      "password": "your_password"
    }
  }
}

Security Notes

• Credentials are stored in memory only and are cleared when the server stops
• The SQLite database is stored locally and should be protected
• Never share your credentials or the database file

Development

For development with hot reloading:

npm run dev

Troubleshooting

Chromium Issues

If you encounter issues with Chromium:

1. Make sure Chromium is installed and accessible

2. Verify the path in `CHROMIUM_PATH` environment variable or `src/config.ts`

3. Install Chromium via Homebrew: `brew install chromium`