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