FindMCP Logo FindMCP.info
YNAB MCP

YNAB MCP

site icon
2025.04.22 0
JavaScript财务管理预算管理金融服务
YNAB MCP是一个基于Docker的MCP服务器，用于实现Claude Code与You Need A Budget（YNAB）的集成。它通过OAuth流程提供全面的API，支持预算管理、交易跟踪和财务分析。主要功能包括OAuth认证、预算和账户管理、交易创建和分类、多预算支持以及速率限制处理。适用于个人和家庭财务管理场景。
View on GitHub

Overview

基本能力

产品定位

YNAB MCP是一个专为财务管理设计的服务，用于连接Claude Code和YNAB（You Need A Budget）平台。

核心功能

  • OAuth-based authentication with YNAB API
  • Complete budget and account management
  • Transaction creation and categorization
  • Support for multiple budgets (personal and family)
  • Rate limit handling (YNAB API limit: 200 requests/hour)
  • Caching for improved performance

适用场景

  • 个人财务管理
  • 家庭预算管理
  • 财务分析和报告

工具列表

  • Docker: 用于容器化部署
  • Node.js v18+: 用于开发和运行
  • Claude Code CLI: 用于与Claude集成
  • YNAB JavaScript SDK: 用于与YNAB API交互

常见问题解答

  • 如何存储敏感数据？ Tokens are stored securely in a mounted Docker volume
  • 是否支持只读模式？ Support for read-only mode

使用教程

使用依赖

  • Docker
  • Node.js v18+ (for development)
  • Claude Code CLI
  • YNAB account

安装教程

  1. Clone this repository
  2. Copy config/config.example.js to config/config.js and add your YNAB API credentials
  3. Build the Docker image: docker build -t ynab-mcp:latest .
  4. Create a JSON configuration for Claude: json { "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" ] }
  5. Register the MCP with Claude Code CLI: bash 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"]}' You can also save the JSON to a file and use: bash claude mcp add-json ynab "$(cat config.json)"
  6. Authenticate with your YNAB account when prompted by Claude

调试方式

  • 检查Docker容器是否正常运行
  • 验证OAuth认证流程
  • 检查API调用是否成功

许可证

该项目遵循 None 开源许可条款。