You Need An MCP

你需要一个mcp

MCP服务器，提供LLM对YNAB预算的访问。

设置

1.安装依赖项

uv sync

2.获取YNAB访问令牌

要使用此MCP服务器，您需要YNAB个人访问令牌：

1. 登录您的YNAB帐户https://app.youneedabudget.com
2. 首选 帐户设置 （点击右上角的电子邮件）
3. 点击 开发人员设置 在左侧边栏中
4. 点击 新令牌
5. 输入令牌名称（例如“MCP服务器”）
6. 点击 生成
7. 复制生成的令牌（您将无法再次看到它）

3.设置环境变量

export YNAB_ACCESS_TOKEN=your_token_here

（可选）设置默认预算ID，以避免在每次调用中都必须指定它：

export YNAB_DEFAULT_BUDGET=your_budget_id_here

4.运行服务器

uv run python server.py

可用工具

• list_budgets() -返回您的所有YNAB预算
• list_accounts(budget_id=None, limit=100, offset=0, include_closed=False) -返回具有分页和筛选功能的帐户
• list_categories(budget_id=None, limit=50, offset=0, include_hidden=False) -返回具有分页和筛选功能的类别
• list_category_groups(budget_id=None) -返回带有总计的类别组（轻量级概述）

分页

这 list_accounts 和 list_categories 工具支持分页。使用 offset 获取后续页面的参数：

• 首页： list_categories(limit=50, offset=0)
• 第二页： list_categories(limit=50, offset=50)
• 检查 pagination.has_more 看看是否有更多结果

安全说明

保持YNAB访问令牌的安全，永远不要将其提交给版本控制。该令牌提供对所有预算数据的读取权限。