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 库

• 人类的克劳德