Finance Tracker MCP 서버

Model Context Protocol(MCP)을 사용하여 Claude AI를 통해 개인 재무를 분석하는 AI 기반 도구입니다.

기능

이 MCP 서버는 Claude AI를 금융 거래 데이터에 연결하여 재무 상태에 대한 자연어 질의를 가능하게 합니다:

• "이번 달 지출 보여줘"

• "내 구독 서비스 모두 찾아줘"

• "가장 큰 지출 10가지는 뭐야?"

• "지난 3개월간의 지출 추세 보여줘"

• "스타벅스 거래 내역 모두 검색해줘"

• "예산 확인: 외식 500달러, 쇼핑 300달러"

Related MCP server: My Finance MCP Server

주요 기능

• 6가지 재무 분석 도구

  • 월간 지출 요약

  • 구독 서비스 감지 (정기 결제)

  • 예산 추적 및 알림

  • 지출 추세 분석

  • 상위 지출 항목 순위

  • 거래 내역 검색

• Plaid 연동

  • 10,000개 이상의 은행 연결 (테스트용 샌드박스 모드)

  • 실시간 거래 데이터 (실제 계좌 연결 시)

  • 안전한 API 액세스

• 개인정보 보호 우선

  • 모든 데이터는 로컬 기기에 저장

  • 외부 데이터 저장소 없음

  • 암호화된 API 연결

빠른 시작

사전 요구 사항

• Python 3.9 이상

• Claude Desktop 앱

• Plaid 계정 (https://dashboard.plaid.com 에서 무료 생성)

설치

1. 저장소 복제

   git clone https://github.com/yourusername/finance-plaid-mcp.git
   cd finance-plaid-mcp

2. 가상 환경 생성

   python -m venv venv
   
   # Activate it:
   # Windows:
   venv\Scripts\activate
   # Mac/Linux:
   source venv/bin/activate

3. 의존성 설치

   pip install -r requirements.txt

4. Plaid API 키 설정

   .env.example 파일을 .env로 복사하고 https://dashboard.plaid.com 에서 발급받은 Plaid 키를 추가하세요.

   PLAID_CLIENT_ID=your_client_id_here
   PLAID_SECRET=your_sandbox_secret_here
   PLAID_ENV=sandbox
   DATA_DIR=./data

5. 샘플 데이터 생성 (테스트용)

   python generate_sample_data.py

6. Claude Desktop 설정

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

   Windows: %APPDATA%\Claude\claude_desktop_config.json

   Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

   {
     "mcpServers": {
       "finance-tracker": {
         "command": "python",
         "args": [
           "/FULL/PATH/TO/finance-plaid-mcp/src/server.py"
         ]
       }
     }
   }

중요: 프로젝트의 전체 절대 경로를 사용하세요!

7. Claude Desktop 재시작

8. 테스트!

   Claude에게 다음과 같이 질문해보세요: "Find all my subscriptions"

📁 프로젝트 구조

finance-plaid-mcp/ ├── src/ │ ├── server.py # MCP 서버 (메인 진입점) │ ├── plaid_client.py # Plaid API 연동 │ ├── analyzer.py # 거래 분석 로직 │ └── config.py # 설정 및 환경 변수 ├── data/ │ └── sample_transactions.json # 생성된 테스트 데이터 ├── screenshot.png # 데모 스크린샷 ├── .env # API 키 (git에 커밋하지 마세요) ├── .env.example # API 키 템플릿 ├── .gitignore # 보안 정보 커밋 방지 ├── requirements.txt # Python 의존성 └── README.md # 이 파일

🔧 사용 가능한 도구

Claude는 재무 분석 시 다음 도구들을 호출할 수 있습니다:

🏦 실제 은행 계좌 연결

현재 샌드박스 모드 (테스트 데이터만 사용 가능)

실제 은행을 연결하려면:

1. Plaid 대시보드에서 개발(Development) 모드로 전환

2. .env 업데이트: PLAID_ENV=development

3. Plaid Link UI 구현 (은행 로그인을 위한 웹 인터페이스)

포트폴리오/데모 목적이라면 실제 금융 데이터 노출을 피하기 위해 샌드박스 모드를 권장합니다.

📊 샘플 출력

구독 서비스 찾기: 19개의 구독 서비스 발견, 연간 총 18,123달러 주요 구독 서비스:

Comcast Internet: 월 130.71달러 (총 915달러) Apple Store: 월 180.05달러 (총 900달러) Verizon Phone Bill: 월 110.75달러 (총 886달러) Electric Bill: 월 119.86달러 (총 839달러) Zara: 월 151.91달러 (총 760달러)

월간 요약: 월간 합계: 1,510달러 수입: 5,000달러 지출: 3,490달러 순수익: 1,510달러 카테고리별 지출:

식료품: 644달러 쇼핑: 900달러 공과금: 886달러 외식: 450달러 교통: 380달러

🛠️ 기술 스택

• Python 3.14

• MCP SDK - Model Context Protocol

• Plaid API - 은행 연결 및 거래 데이터

• Pandas - 데이터 분석

• Claude AI - 자연어 인터페이스

🔐 보안 및 개인정보 보호

• ✅ API 키는 .env에 저장 (절대 커밋하지 않음)

• ✅ 모든 데이터는 로컬에서 처리

• ✅ 외부 로깅이나 분석 없음

• ✅ Plaid는 은행 수준의 암호화 제공

⚠️ 중요: .env 파일이나 API 키를 GitHub에 절대 커밋하지 마세요!

🤝 기여하기

기여를 환영합니다! 자유롭게 다음을 수행하세요:

• 버그 보고

• 기능 제안

• 풀 리퀘스트 제출

📝 라이선스

MIT 라이선스

🙏 감사의 말

• Anthropic의 MCP로 제작됨

• Plaid 제공

⭐ 이 프로젝트가 도움이 되었다면 저장소에 별을 눌러주세요!