Finance MCP

Gestión de finanzas personales mediante Model Context Protocol (MCP).

Descripción general

Este servidor MCP proporciona herramientas para gestionar las finanzas personales:

• Cuentas: Cuentas bancarias, tarjetas de crédito, ahorros

• Transacciones: Ingresos, gastos, transferencias

• Deudas: Seguimiento de deudas y pagos

• Pagos mensuales: Seguimiento de mensualidades (MSI)

• Gastos fijos: Gastos mensuales recurrentes

• Préstamos activos: Dinero que otros te deben

• Ahorros: Seguimiento de objetivos y movimientos

• Presupuestos: Límites de presupuesto mensual

• Activos: Inventario de activos personales

Related MCP server: monarchmoney-node

Instalación

# 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

Uso

Con Hermes Agent

Añade lo siguiente a ~/.hermes/config.yaml:

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

Uso independiente

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

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

Herramientas disponibles

Cuentas

• list_accounts - Lista todas las cuentas

• get_account - Obtiene los detalles de una cuenta

• create_new_account - Crea una nueva cuenta

• update_account_balance - Actualiza el saldo de una cuenta

Categorías

• list_categories - Lista todas las categorías

• get_category - Obtiene los detalles de una categoría

Transacciones

• list_transactions - Lista las transacciones con filtros

• add_transaction - Registra una nueva transacción

Deudas

• list_debts - Lista las deudas

• get_debt - Obtiene los detalles de una deuda

• add_debt - Registra una nueva deuda

• record_debt_payment - Registra un pago de deuda

Pagos mensuales (MSI)

• list_monthly_payments - Lista las mensualidades

• add_monthly_payment - Registra una nueva mensualidad

Gastos fijos

• list_fixed_expenses - Lista los gastos fijos

• add_fixed_expense - Añade un gasto fijo

Préstamos activos

• list_active_loans - Lista los préstamos concedidos a otras personas

• add_active_loan - Registra un nuevo préstamo

• record_loan_payment - Registra el pago recibido

Ahorros

• list_savings - Lista los objetivos de ahorro

• get_savings_goal - Obtiene los detalles de un objetivo de ahorro

• add_savings_goal - Crea un objetivo de ahorro

• record_savings_movement - Deposita/retira de los ahorros

• list_savings_movements - Consulta el historial de ahorros

Presupuestos

• list_budgets - Lista los presupuestos

Activos

• list_assets - Lista los activos personales

• get_assets_total - Obtiene el valor total de los activos

Resúmenes

• get_account_overview - Resumen rápido de la cuenta

• get_monthly_report - Informe mensual de ingresos y gastos

Esquema de la base de datos

Consulta schema/init.sql para ver el esquema completo de la base de datos.

Estructura del proyecto

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

Licencia

MIT