Finance MCP

Управление личными финансами через Model Context Protocol (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