Asher - Personal Financial Data MCP Server

Asher - 個人財務データ MCP サーバー

自分のデータを、驚くほど活用しましょう！

TypeScript で構築され、israeli-bank-scrapers を活用した、イスラエルの銀行やクレジットカード会社向けの、安全でローカル優先の財務データアグリゲーターです。Asher を使えば、データのプライバシーと安全性を保ちながら、複数のソースにまたがる財務取引を集約して分析できます。 データはスクレイピングされ、ローカルの暗号化された SQLite データベースに保存されます。

機能

• MCP サーバー：Model Context Protocol を実装しており、MCP ホスト（例：Claude）と簡単に連携できます。
• 幅広い連携：israeli-bank-scrapers が提供する、イスラエルのすべての銀行やクレジットカード会社に対応しています。
• ローカル優先：財務データが端末の外に出ることはありません。
• 暗号化：機密データは保存時に暗号化されます。
• CLI：コマンドラインから簡単にセットアップや管理ができます。
• TypeScript：型安全性を重視して構築されています。

前提条件

• Node.js 18+
• npm

インストール

1. リポジトリをクローンします：

   git clone https://github.com/shlomiuziel/asher-mcp.git
   cd asher-mcp
   

2. 依存関係をインストールします：

   npm install
   

3. プロジェクトをビルドします：

   npm run build
   

4. 任意：システム全体で使える asher CLI コマンドをインストールします：

   npm install -g .
   

5. tsx（TypeScript Execute）をグローバルにインストールします（Claude デスクトップとの連携に必要です）：

   npm install -g tsx
   

データベースの保存場所

データベースファイルは、お使いの OS に応じて以下の場所に保存されます：

• macOS： ~/Library/Application Support/Asher/database.db
• Linux： ~/.local/share/Asher/database.db
• Windows： %APPDATA%/Asher/database.db

初回起動と設定

1. プロバイダーの認証情報を含む credentials.json ファイルを用意します。 対応するプロバイダーと認証情報の項目については、こちらをご覧ください。

2. 認証情報を登録します：

   asher ingest-creds -f credentials.json
   

   • このコマンドを使って、必要に応じて認証情報を更新できます。削除は手動で行えます（scraper_credentials テーブルを参照）。
   • データベースの暗号化キーを入力するよう求められます（初回セットアップ時は、確認のため再入力します）。

3. セットアップ中に、以下の操作を求められます：

   • 通知を有効にする（権限の確認に役立つテスト通知が送信されます）
   • 初回のスクレイピングを任意で実行する（データ量が多いため、遅延やタイムアウトの可能性を避けるために推奨します）
   • Claude Desktop との連携を設定する（npm run configure:claude で直接起動できます）

使い方

MCP ツール

Asher は MCP ホスト向けに、次のツールを提供します：

• fetchTransactions：最近の取引を取得して、データベースに保存します。
• describeTable：テーブルの詳細情報（列、インデックス）を取得します。
• listTables：データベース内のすべてのテーブルを一覧表示します。
• getTableSchema：指定したテーブルのスキーマを取得します。
• sqlQuery：許可されたテーブルに対して安全な SELECT クエリを実行します（SQL インジェクションや不正アクセスを防止します）。
• fetch-last-month-transactions：先月の取引を取得し、取引と支出を要約します。

詳細な月次レポートの生成に役立つサンプルプロンプトが含まれています。

MCP サーバーをテストする

ローカルテストには、MCP Inspector を実行できます：

npm run start:mcp:inspector

セキュリティ

• すべての機密データは保存時に暗号化されます。
• 銀行の認証情報は、暗号化キーを使用してデータベース内に安全に保存されます。
• アプリケーションは最小権限の原則に従っています（データベースファイルに chmod 600 を適用）。
• 暗号化キーは実行時に要求され、ディスクに保存されることはありません。

テスト

すべてのテストを実行します：

npm test

ライセンス

このプロジェクトは MIT ライセンスのもとでライセンスされています。詳細は LICENSE ファイルをご覧ください。

⚠️ 重要な免責事項

このソフトウェアを使用する前に、この免責事項をよくお読みください。

このソフトウェアは、財務データの分析を支援し、MCP ホストから利用できるようにすることを目的としています。ただし、このソフトウェアを使用することで、以下の事項を認め、同意したものとみなされます。

1. 保証の否認：このソフトウェアは「現状有姿」で提供され、明示的または黙示的を問わず、いかなる種類の保証もありません。これには、商品性、特定目的への適合性、権利非侵害に関する保証が含まれますが、これらに限定されません。

2. 財務データのセキュリティ：

   • 銀行の認証情報および財務データのセキュリティについては、お客様が単独で責任を負います
   • 認証情報や暗号化キーを他人と共有しないでください
   • 開発者は、お客様の金融口座への不正アクセスについて責任を負いません

3. 自己責任での使用：

   • 開発者は、このソフトウェアの使用に起因する金銭的損失、データ損失、その他の損害について責任を負いません
   • 重要な財務情報は、必ず銀行の公式窓口を通じて確認してください
   • このソフトウェアは、すべての金融機関と互換性があるとは限りません

4. 責任の否認：いかなる場合も、作者または著作権者は、契約、不法行為、その他のいずれに基づく請求、損害、その他の責任についても、ソフトウェアまたはその使用、その他ソフトウェアに関する取引に起因または関連するものについて、責任を負いません。

5. サードパーティサービス：このソフトウェアは、サードパーティサービスと連携する場合があります。開発者は、これらの第三者の行為、コンテンツ、ポリシーについて責任を負いません。

このソフトウェアを使用することで、お客様は本免責事項を読み、その条件に拘束されることに同意したものとみなされます。