you-need-an-mcp

提供LLMs访问YNAB预算的MCP服务器。

配置

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访问令牌安全，并且永远不要将其提交到版本控制中。该令牌提供了对您所有预算数据的读取权限。