YNAB MCP

YNAB MCP

Claude Code와 You Need A Budget(YNAB)의 통합을 위한 YNAB 모델 컨텍스트 프로토콜(MCP) 서버입니다.

개요

이 저장소에는 Claude Code가 YNAB(You Need A Budget) 계정과 상호 작용할 수 있도록 하는 Docker 기반 MCP 서버가 포함되어 있습니다. OAuth 흐름을 구현하고 예산 관리, 거래 추적 및 재무 분석을 위한 포괄적인 API를 제공합니다.

특징

• YNAB API를 사용한 OAuth 기반 인증
• 완벽한 예산 및 계정 관리
• 거래 생성 및 분류
• 다양한 예산 지원(개인 및 가족)
• 속도 제한 처리(YNAB API 제한: 시간당 200개 요청)
• 성능 향상을 위한 캐싱

시작하기

필수 조건

• 도커
• Node.js v18+ (개발용)
• 클로드 코드 CLI
• YNAB 계정

설치

1. 이 저장소를 복제하세요
2. config/config.example.js``config/config.js 로 복사하고 YNAB API 자격 증명을 추가합니다.
3. Docker 이미지를 빌드합니다: docker build -t ynab-mcp:latest .
4. Claude에 대한 JSON 구성을 만듭니다.지엑스피1
5. Claude Code CLI로 MCP 등록:
   claude mcp add-json ynab '{"command": "docker", "args": ["run", "--rm", "-i", "-v", "/path/to/data:/app/data", "-v", "/path/to/config:/app/config", "-e", "NODE_ENV=production", "ynab-mcp:latest"]}'
   JSON을 파일에 저장하고 다음을 사용할 수도 있습니다.
   claude mcp add-json ynab "$(cat config.json)"
6. Claude의 지시에 따라 YNAB 계정으로 인증하세요.

Claude와의 통합

이 MCP는 Claude와 완벽하게 통합되어 다음을 가능하게 합니다.

• 예산 및 거래 보기
• 재정적 통찰력 얻기
• 자연스러운 대화를 통해 예산 관리하기

보안

• 토큰은 마운트된 Docker 볼륨에 안전하게 저장됩니다.
• 민감한 데이터는 기록되지 않습니다.
• 인증은 OAuth 2.0 표준을 사용합니다.
• 읽기 전용 모드 지원

구현 세부 사항

구현은 다음을 사용하여 모델 컨텍스트 프로토콜 표준을 따릅니다.

• Node.js와 공식 MCP SDK
• 컨테이너화 및 배포를 위한 Docker
• API 작업을 위한 YNAB JavaScript SDK
• 인증을 위한 OAuth 2.0

특허

MIT

감사의 말

• YNAB API
• YNAB JavaScript 라이브러리
• 인간주의적 클로드