지출 추적기 MCP 서버

Claude와 같은 AI 어시스턴트가 로컬 SQLite 데이터베이스를 사용하여 개인 지출을 관리(추가, 분류, 요약 및 예산 설정)할 수 있게 해주는 MCP(Model Context Protocol) 서버입니다.

개요

이 서버는 Claude(또는 MCP 호환 클라이언트)가 지출을 추적하기 위해 호출할 수 있는 일련의 MCP 도구를 제공합니다. 모든 데이터는 로컬 SQLite 파일에 저장되며, 클라우드나 계정이 필요하지 않습니다.

주요 기능

• 카테고리, 금액, 날짜, 설명과 함께 지출 추가 및 관리

• 날짜 범위 또는 카테고리별로 지출 필터링 및 목록 조회

• 카테고리 또는 월별 지출 요약

• 카테고리별 예산 설정 및 잔액 확인

• CSV로 지출 내역 내보내기

• 완전한 로컬 환경 — 데이터가 사용자 기기에만 저장됨

MCP 도구

프로젝트 구조

expense-tracker-mcp-server/
├── main.py             # MCP server entry point (all tools)
├── expenses.db         # SQLite database (auto-created on first run)
├── pyproject.toml      # Project metadata and dependencies
├── .venv/              # Virtual environment (created by uv)
└── readme.md

사전 요구 사항

• Python 3.11 이상

• uv (권장) 또는 pip

• Claude Desktop (MCP 서버 연결용)

설치

# Clone the repo
git clone https://github.com/your-username/expense-tracker-mcp-server.git
cd expense-tracker-mcp-server

# Initialize the project and install dependencies
uv init
uv add fastmcp

이 명령은 프로젝트 디렉토리 내에 .venv 폴더를 자동으로 생성합니다.

서버 실행

fastmcp run main.py

서버가 시작되고 stdio를 통해 MCP 연결을 대기합니다. SQLite 데이터베이스(expenses.db)는 처음 실행 시 자동으로 생성됩니다.

Claude Desktop에 연결

Claude Desktop 설정 파일에 다음 내용을 추가하세요:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "expense-tracker": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Learning\\Expense-Tracker-MCP-Server",
        "run",
        "fastmcp",
        "run",
        "main.py"
      ]
    }
  }
}

Claude Desktop을 완전히 종료(시스템 트레이 → 종료)한 후 다시 실행하세요. 도구 패널에서 지출 추적기 도구를 확인할 수 있습니다.

예시 프롬프트

Claude에 연결되면 다음과 같이 말할 수 있습니다:

• "오늘 Whole Foods에서 식료품비로 45달러 지출 추가해줘"

• "이번 달 식비 지출 내역 모두 보여줘"

• "지난달에 가장 많이 지출한 항목이 뭐야?"

• "외식비로 월 300달러 예산을 설정해줘"

• "엔터테인먼트 예산이 얼마나 남았어?"

• "3월 지출 내역을 모두 CSV로 내보내줘"

개발

# Run with MCP inspector for debugging
fastmcp dev inspector main.py

라이선스

MIT