런치머니-MCP

런치머니 MCP 서버

Claude와 다른 AI 도우미를 통해 Lunchmoney 거래 및 예산과 상호 작용할 수 있는 MCP(Model Context Protocol) 서버입니다.

이게 뭔가요?

이 도구를 사용하면 Lunchmoney의 재무 데이터를 Claude AI에 연결하여 지출에 대한 질문을 하고, 예산을 분석하고, 자연스러운 대화를 통해 재정에 대한 통찰력을 얻을 수 있습니다.

특징

이 서버는 4가지 주요 도구를 제공합니다.

get-recent-transactions : 지난 N일 동안의 최근 거래를 확인합니다.
검색-거래 : 수취인 이름이나 메모의 키워드로 거래 검색
get-category-spending : 특정 카테고리의 지출 분석
get-budget-summary : 지출, 남은 금액, 반복 항목을 포함한 자세한 예산 정보를 가져옵니다.

개인정보 보호 및 데이터 처리

중요: MCP는 Claude가 개인정보 보호 경계를 유지하면서 Lunchmoney 데이터와 상호 작용할 수 있는 체계적인 방법을 제공합니다. 다음 사항을 알아두세요.

Claude(호스트)는 로컬 MCP 서버에 연결하는 클라이언트를 생성합니다.
귀하의 Lunchmoney API 토큰은 귀하의 로컬 컴퓨터에 남아 있습니다.
MCP 서버는 로컬로 실행되며 Lunchmoney의 API에서 데이터를 가져옵니다.
Lunchmoney 데이터에 액세스하려면 각 요청을 승인하라는 메시지가 표시됩니다.
귀하가 재정에 관해 질문할 때 Claude는 MCP 서버에서 특정 정보를 요청합니다.
MCP 서버는 로컬로 요청을 처리하고 관련 결과만 반환합니다.
Claude는 귀하의 전체 재무 데이터나 API 토큰에 직접 액세스할 수 없습니다.
요청된 특정 정보(거래 요약 또는 예산 상태 등)만 Claude와 공유됩니다.
Anthropic의 데이터 보존 정책은 대화의 일부인 이러한 요약 결과에 적용됩니다.
각 서버 연결은 격리되어 명확한 보안 경계를 유지합니다.

MCP에 대한 자세한 내용은 문서에서 확인할 수 있습니다: https://modelcontextprotocol.io/introduction .

설치

또한 공식 Claude 문서를 살펴보세요: https://modelcontextprotocol.io/quickstart/user

npx 사용하기

Node.js는 웹 브라우저 외부에서 JavaScript 코드를 실행할 수 있는 소프트웨어 플랫폼입니다.

Node.js를 설치하려면:

Windows/Mac : 공식 Node.js 웹사이트 에서 설치 프로그램을 다운로드하여 실행하세요.
Homebrew를 사용하는 Mac : 터미널에서 brew install node 실행합니다.
Linux : 패키지 관리자를 사용하세요(예: Ubuntu의 경우 sudo apt install nodejs )

컴퓨터에 Node.js를 설치하면 아무것도 다운로드하지 않고도 서버를 직접 실행할 수 있습니다.

Lunchmoney 개발자 설정 에서 Lunchmoney API 토큰을 받으세요.
클로드 데스크톱 열기
설정 → 개발자 -> Edit Config 으로 이동하세요.
다음 구성을 추가합니다.

지엑스피1

your_token_here 실제 Lunchmoney API 토큰으로 바꾸세요.

중요 참고 사항: 구성을 변경한 후 변경 사항을 적용하려면 Claude Desktop을 다시 시작해야 할 수 있습니다.

사용 예

Claude Desktop에서 구성한 후 다음과 같은 질문을 할 수 있습니다.

업무

"지난주 최근 거래 내역 보여주세요"
"Amazon의 모든 거래 내역 검색"
"지난달 식당에 얼마 썼지?"
"사업 비용으로 태그된 거래 찾기"

예산

"이번 달 예산 요약을 보여주세요"
"2024년 1월부터 3월까지 내 예산 상황은 어때요?"
"내 식비 예산이 얼마나 남았나요?"
"예산을 초과한 카테고리를 보여주세요"

MCP란 무엇인가요?

모델 컨텍스트 프로토콜(MCP) 은 애플리케이션이 대규모 언어 모델(LLM)에 컨텍스트를 제공하는 방식을 표준화하는 개방형 프로토콜입니다. MCP는 AI 애플리케이션을 위한 USB-C 포트와 같습니다. AI 모델을 다양한 데이터 소스 및 도구에 연결하는 표준화된 방식을 제공합니다.

MCP의 주요 이점:

LLM에 데이터와 기능을 노출하는 표준화된 방법
인간 참여 보안(모든 작업에 사용자 승인 필요)
사전 구축된 통합의 성장하는 생태계
다양한 AI 모델 및 애플리케이션과 함께 작동합니다.

문제 해결

Claude는 내 MCP 서버에 연결할 수 없다고 말합니다.

Claude의 개발자 설정에서 구성이 올바른지 확인하세요.
구성을 변경한 후 Claude Desktop을 다시 시작해 보세요.
Lunchmoney API 토큰이 유효한지 확인하세요

클로드는 Lunchmoney 명령을 인식하지 못합니다.

Claude에서 새로운 대화를 시작하세요
질의에 Lunchmoney를 명시적으로 언급해 보세요(예: "최근 Lunchmoney 거래 내역 보기").

API 참고사항

예산 데이터는 날짜에 대해 월 경계를 사용해야 합니다(예: 2024-01-01 ~ 2024-01-31).
거래에는 모든 날짜 범위를 사용할 수 있습니다.
모든 화폐 가치는 원래 통화로 반환됩니다.

특허

MIT

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

lunchmoney-mcp