Expense Tracker MCP Server

Claude를 통해 개인 지출을 기록, 목록화, 요약, 삭제할 수 있는 가벼운 로컬 MCP(Model Context Protocol) 서버입니다. 앱도, 수동 스프레드시트 입력도 없이 자연스러운 대화만으로 가능합니다.

FastMCP로 구축되었으며 로컬 SQLite 데이터베이스를 기반으로 합니다.

왜

대부분의 지출 추적 앱은 불편합니다. 커피 한 잔을 기록하는 데도 너무 많은 탭, 경직된 카테고리, 또는 구독 결제 장벽이 있죠. 이 서버는 Claude를 여러분의 지출 추적기로 만들어 줍니다. 지출 내역을 말하기만 하면 저장됩니다. 언제든 요약을 요청하면 카테고리별로 즉시 분석 결과를 얻을 수 있습니다.

Related MCP server: Expense Tracker MCP Server

기능

• 지출 추가 — 날짜, 카테고리, 금액, 하위 카테고리, 메모 포함

• 지출 목록 — 날짜 범위 내 지출 표시

• 지출 요약 — 카테고리별 (선택적으로 특정 카테고리로 필터링)

• 지출 삭제 — ID로 삭제

• 데이터는 단일 SQLite 파일에 로컬로 저장 — 완전히 비공개, 클라우드 동기화 없음

요구 사항

• Python 3.10+

• fastmcp

의존성 설치:

pip install fastmcp

설정

1. 서버 스크립트(예: expense_server.py)를 컴퓨터의 영구적인 위치에 저장합니다.

2. 첫 실행 시 같은 디렉토리에 expenses.db가 자동으로 생성됩니다 — 수동 DB 설정이 필요 없습니다.

3. Claude Desktop 설정 파일에 추가합니다:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   {
     "mcpServers": {
       "expense-tracker": {
         "command": "python",
         "args": ["/full/absolute/path/to/expense_server.py"]
       }
     }
   }

   스크립트의 절대 경로를 사용하세요. 가상 환경을 사용하는 경우 command를 시스템 python 대신 해당 환경의 Python 바이너리로 지정하세요.

4. Claude Desktop을 재시작합니다. 아래 네 가지 도구가 사용 가능하게 표시됩니다.

도구

날짜는 YYYY-MM-DD 형식이어야 합니다.

사용 예시

서버가 연결되면 Claude에게 자연스럽게 말하기만 하면 됩니다:

• "오늘 식료품 450, 하위 카테고리 채소로 기록해줘"

• "어제 월세 1200 썼어, 메모: 8월 월세"

• "이번 달 지출 전부 보여줘"

• "2026년 8월 카테고리별 내역 알려줘"

• "8월 1일부터 15일까지 식비로 얼마 썼어?"

• "지출 #12 삭제해줘, 두 번 입력했어"

데이터 저장

모든 데이터는 스크립트 옆에 생성되는 SQLite 파일인 expenses.db에 저장됩니다. 다른 곳으로 전송되는 것은 없습니다 — 완전히 로컬 및 비공개입니다.

스키마:

expenses
├── id            INTEGER PRIMARY KEY AUTOINCREMENT
├── date          TEXT NOT NULL
├── category      TEXT NOT NULL
├── amount        REAL NOT NULL
├── subcategory   TEXT DEFAULT ''
└── note          TEXT DEFAULT ''

데이터 백업

모든 것이 하나의 파일에 있으므로 주기적으로 백업하세요:

cp expenses.db "expenses_backup_$(date +%Y%m%d).db"

주간 cron 작업(macOS/Linux) 또는 작업 스케줄러(Windows)로 자동화하는 것을 고려하세요.

참고 및 팁

• 카테고리 이름은 제한되지 않으므로 대소문자/철자를 일관되게 유지하세요(예: 항상 "Groceries"로, "groceries" / "Grocery" 혼용하지 않기) — 요약을 깔끔하게 유지하려면.

• 중복을 피하려면 새 카테고리를 추가하기 전에 Claude에게 기존 카테고리를 나열하도록 요청하세요.

• 이 서버는 인증이나 네트워크 노출이 없습니다 — stdio를 통해 로컬에서만 실행되므로 추가 보안 설정 없이 사용해도 안전합니다.

라이선스

개인용 — 자신의 워크플로에 맞게 자유롭게 수정하세요.