Finance Tracker MCP Server

Model Context Protocol (MCP) を使用した、Claude AIによるAI駆動の個人財務分析ツールです。

このツールの機能

このMCPサーバーは、Claude AIを金融取引データに接続し、財務に関する自然言語での問い合わせを可能にします：

• 「今月の支出を見せて」

• 「サブスクリプションをすべて見つけて」

• 「上位10件の支出は何？」

• 「過去3ヶ月の支出傾向を表示して」

• 「スターバックスの取引をすべて検索して」

• 「予算を確認：外食500ドル、ショッピング300ドル」

Related MCP server: My Finance MCP Server

特徴

• 6つの財務分析ツール

  • 月間支出サマリー

  • サブスクリプション検出（定期的な支払い）

  • 予算追跡とアラート

  • 支出傾向分析

  • 上位支出ランキング

  • 取引検索

• Plaid統合

  • 10,000以上の銀行に接続可能（テスト用のサンドボックスモード）

  • リアルタイムの取引データ（実際の口座に接続時）

  • セキュアなAPIアクセス

• プライバシー重視

  • すべてのデータはローカルマシン上に保持

  • 外部データストレージなし

  • 暗号化されたAPI接続

クイックスタート

前提条件

• Python 3.9以上

• Claude Desktopアプリ

• Plaidアカウント (https://dashboard.plaid.com で無料作成可能)

インストール

1. リポジトリをクローン

   git clone https://github.com/yourusername/finance-plaid-mcp.git
   cd finance-plaid-mcp

2. 仮想環境を作成

   python -m venv venv
   
   # Activate it:
   # Windows:
   venv\Scripts\activate
   # Mac/Linux:
   source venv/bin/activate

3. 依存関係をインストール

   pip install -r requirements.txt

4. Plaid APIキーを設定

   .env.example を .env にコピーし、https://dashboard.plaid.com から取得したPlaidキーを追加します。

   PLAID_CLIENT_ID=your_client_id_here
   PLAID_SECRET=your_sandbox_secret_here
   PLAID_ENV=sandbox
   DATA_DIR=./data

5. サンプルデータを生成 (テスト用)

   python generate_sample_data.py

6. Claude Desktopを設定

   Claude Desktopの設定ファイルに以下を追加します：

   Windows: %APPDATA%\Claude\claude_desktop_config.json

   Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

   {
     "mcpServers": {
       "finance-tracker": {
         "command": "python",
         "args": [
           "/FULL/PATH/TO/finance-plaid-mcp/src/server.py"
         ]
       }
     }
   }

重要: プロジェクトへのフル絶対パスを使用してください！

7. Claude Desktopを再起動

8. テスト！

   Claudeで以下のように質問してください： 「サブスクリプションをすべて見つけて」

📁 プロジェクト構造

finance-plaid-mcp/ ├── src/ │ ├── server.py # MCPサーバー (メインエントリーポイント) │ ├── plaid_client.py # Plaid API統合 │ ├── analyzer.py # 取引分析ロジック │ └── config.py # 設定と環境変数 ├── data/ │ └── sample_transactions.json # 生成されたテストデータ ├── screenshot.png # デモのスクリーンショット ├── .env # APIキー (gitにコミットしないこと) ├── .env.example # APIキーのテンプレート ├── .gitignore # シークレットのコミットを防止 ├── requirements.txt # Pythonの依存関係 └── README.md # このファイル

🔧 利用可能なツール

Claudeは財務分析時に以下のツールを呼び出すことができます：

🏦 実際の銀行口座への接続

現在はサンドボックスモード (テストデータのみ)

実際の銀行に接続するには：

1. Plaidダッシュボードで開発モードに切り替える

2. .env を更新: PLAID_ENV=development

3. Plaid Link UI（銀行ログイン用のWebインターフェース）を実装する

ポートフォリオやデモ目的の場合は、実際の財務データが露出するのを避けるため、サンドボックスモードを推奨します。

📊 出力サンプル

サブスクリプションの検索: 19件のサブスクリプションが見つかりました。合計年間18,123ドル 上位のサブスクリプション:

Comcast Internet: 月額130.71ドル (合計915ドル) Apple Store: 月額180.05ドル (合計900ドル) Verizon Phone Bill: 月額110.75ドル (合計886ドル) Electric Bill: 月額119.86ドル (合計839ドル) Zara: 月額151.91ドル (合計760ドル)

月間サマリー: 月間合計: 1,510ドル 収入: 5,000ドル 支出: 3,490ドル 純利益: 1,510ドル カテゴリ別支出:

食料品: 644ドル ショッピング: 900ドル 公共料金: 886ドル 外食: 450ドル 交通費: 380ドル

🛠️ 技術スタック

• Python 3.14

• MCP SDK - Model Context Protocol

• Plaid API - 銀行接続と取引データ

• Pandas - データ分析

• Claude AI - 自然言語インターフェース

🔐 セキュリティとプライバシー

• ✅ APIキーは .env に保存（コミット不可）

• ✅ すべてのデータはローカルで処理

• ✅ 外部へのログ送信や分析はなし

• ✅ Plaidによる銀行レベルの暗号化

⚠️ 重要: .env ファイルやAPIキーをGitHubにコミットしないでください！

🤝 貢献

貢献を歓迎します！お気軽にどうぞ：

• バグの報告

• 機能の提案

• プルリクエストの送信

📝 ライセンス

MIT License

🙏 謝辞

• Anthropic's MCP を使用して構築

• Plaid を利用

⭐ 役に立った場合は、リポジトリにスターをお願いします！