Finance MCP

Model Context Protocol（MCP）による個人財務管理。

概要

このMCPサーバーは、個人財務を管理するためのツールを提供します：

• 口座: 銀行口座、クレジットカード、貯蓄

• 取引: 収入、支出、振替

• 負債: 負債と支払いの追跡

• 月々の支払い: 分割払い（MSI）の追跡

• 固定費: 毎月発生する定期支出

• 貸付金: 他人があなたに返済すべきお金

• 貯蓄: 目標と入出金の追跡

• 予算: 毎月の予算上限

• 資産: 個人資産の一覧

Related MCP server: monarchmoney-node

インストール

# Clone the repository
git clone https://github.com/FrancoMeneses/finance-mcp.git
cd finance-mcp

# Install dependencies
pip install -r requirements.txt

# Initialize the database (optional - server creates it on first run)
sqlite3 finance.db < schema/init.sql

使用方法

Hermes Agentで使用する場合

~/.hermes/config.yaml に追加：

mcp_servers:
  finance:
    command: "python3"
    args: ["/path/to/finance-mcp/src/finance/server.py"]
    env:
      DB_PATH: "/path/to/finance.db"

単体で使用する場合

# Set database path
export DB_PATH="/path/to/finance.db"

# Run the server
python src/finance/server.py

利用可能なツール

口座

• list_accounts - すべての口座を一覧表示

• get_account - 口座の詳細を取得

• create_new_account - 新しい口座を作成

• update_account_balance - 口座残高を更新

カテゴリ

• list_categories - すべてのカテゴリを一覧表示

• get_category - カテゴリの詳細を取得

取引

• list_transactions - フィルタ条件で取引を一覧表示

• add_transaction - 新しい取引を記録

負債

• list_debts - 負債を一覧表示

• get_debt - 負債の詳細を取得

• add_debt - 新しい負債を登録

• record_debt_payment - 負債の支払いを記録

月々の支払い（MSI）

• list_monthly_payments - 分割払いを一覧表示

• add_monthly_payment - 新しい分割払いを登録

固定費

• list_fixed_expenses - 固定費を一覧表示

• add_fixed_expense - 固定費を追加

貸付金

• list_active_loans - 他人への貸付金を一覧表示

• add_active_loan - 新しい貸付を登録

• record_loan_payment - 受け取った返済を記録

貯蓄

• list_savings - 貯蓄目標を一覧表示

• get_savings_goal - 貯蓄目標の詳細を取得

• add_savings_goal - 貯蓄目標を作成

• record_savings_movement - 貯蓄への入出金

• list_savings_movements - 貯蓄の履歴を表示

予算

• list_budgets - 予算を一覧表示

資産

• list_assets - 個人資産を一覧表示

• get_assets_total - 資産の合計額を取得

サマリー

• get_account_overview - 口座のクイックサマリー

• get_monthly_report - 月次の収支レポート

データベーススキーマ

完全なデータベーススキーマについては schema/init.sql を参照してください。

プロジェクト構成

finance-mcp/
├── README.md
├── requirements.txt
├── schema/
│   └── init.sql         # Database schema
├── src/
│   └── finance/
│       ├── __init__.py
│       ├── server.py    # MCP server (FastMCP)
│       ├── db.py        # Database access layer
│       └── models.py    # Pydantic validation models
├── tests/
│   └── ...
└── docs/
    └── architecture.md

ライセンス

MIT