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