预算交互协议服务

一个为YNAB(You Need A Budget)设计的模型上下文协议(MCP)服务器,允许Claude与您的预算进行交互。

  • by obviyus
  • TypeScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 obviyus/ynab-mcp

使用说明

ynab mcp

YNAB(您需要预算)的模型上下文协议(MCP)服务器,允许Claude与您的预算进行交互。

特性

工具 说明
list_budgets 列出您YNAB账户的所有可用预算
list_accounts 列出特定预算内的所有账户
get_transactions 使用可选的日期过滤获取帐户的交易记录
get_spending_by_category 按类别获取汇总支出总额
get_categories 获取包含已分配金额、活动和剩余余额的预算类别
get_category_transactions 获取特定类别的交易记录

设置

1.获取YNAB个人访问令牌

  1. 首选 YNAB开发人员设置
  2. 点击“新建令牌”并复制生成的令牌

2.安装依赖项

bun install

3.配置克劳德桌面

编辑您的Claude Desktop配置文件:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 视窗: %APPDATA%\Claude\claude_desktop_config.json

添加YNAB MCP服务器:

{
  "mcpServers": {
    "ynab": {
      "command": "bun",
      "args": ["/path/to/ynab-mcp/index.ts"],
      "env": {
        "YNAB_ACCESS_TOKEN": "your-personal-access-token-here"
      }
    }
  }
}

4.重新启动克劳德桌面

保存配置后,重新启动Claude Desktop以加载MCP服务器。

用法

配置后,您可以向Claude询问以下问题:

  • “YNAB的预算是多少?”
  • “在我的主预算中显示我的账户”
  • “我这个月在支票账户上做了哪些交易?”
  • “上个月我在杂货上花了多少钱?”
  • “我12月份的类别余额是多少?”
  • “显示今年所有餐厅交易”

发展

直接运行服务器进行测试:

YNAB_ACCESS_TOKEN=your-token bun index.ts