YNAB MCP

YNAB MCP

YNAB 模型上下文协议 (MCP) 服务器用于 Claude Code 与 You Need A Budget (YNAB) 的集成。

概述

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

特征

• 使用 YNAB API 进行基于 OAuth 的身份验证
• 完整的预算和账户管理
• 交易创建和分类
• 支持多种预算（个人和家庭）
• 速率限制处理（YNAB API 限制：200 个请求/小时）
• 通过缓存提高性能

入门

先决条件

• Docker
• Node.js v18+（用于开发）
• Claude 代码 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 帐户进行身份验证

与克劳德的整合

该 MCP 与 Claude 无缝集成，可实现：

• 查看预算和交易
• 获取财务见解
• 通过自然对话管理预算

安全

• 令牌安全地存储在已安装的 Docker 卷中
• 未记录任何敏感数据
• 身份验证使用 OAuth 2.0 标准
• 支持只读模式

实现细节

该实现遵循模型上下文协议标准，使用：

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

执照

麻省理工学院

致谢

• YNAB API
• YNAB JavaScript 库
• 人类的克劳德