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