YNAB MCP

用于 Claude Code 与 You Need A Budget (YNAB) 集成的 YNAB Model Context Protocol (MCP) 服务器。

概述

此仓库包含一个基于 Docker 的 MCP 服务器，该服务器使 Claude Code 能够与 YNAB（You Need A Budget）账户进行交互。它实现了 OAuth 流程，并提供了全面的 API 来管理预算、跟踪交易和获取财务见解。

功能

• 基于 OAuth 的 YNAB API 认证
• 完整的预算和账户管理
• 交易创建和分类
• 支持多个预算（个人和家庭）
• 速率限制处理（YNAB API 限制：200 次/小时）
• 缓存以提高性能

开始使用

前提条件

• Docker
• Node.js v18+（开发用）
• Claude Code CLI
• YNAB 账户

安装

1. 克隆此仓库
2. 将 config/config.example.js 复制为 config/config.js 并添加您的 YNAB API 凭据
3. 构建 Docker 镜像：docker build -t ynab-mcp:latest .
4. 为 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. 使用 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 标准
• 支持只读模式

实现细节

实现遵循 Model Context Protocol 标准，使用了以下技术：

• Node.js 和官方 MCP SDK
• Docker 用于容器化和部署
• YNAB JavaScript SDK 用于 API 操作
• OAuth 2.0 用于认证

许可证

MIT

致谢

• YNAB API
• YNAB JavaScript Library
• Anthropic Claude