预算管理助手

YNAB 助手

一个FastMCP服务器，允许AI助手通过模型上下文协议与您的YNAB（You Need A Budget）预算进行交互。

这是什么？

这是一个个人MCP服务器，它将YNAB API功能作为工具暴露出来，供Claude（或其他AI助手）使用。它允许您使用自然语言询问有关您的预算的问题、创建交易、更新类别等。

设置

1. 安装依赖项：

   复制

   uv sync
   

2. 设置您的YNAB访问令牌：

   从（某处）获取您的令牌 YNAB 开发者设置，然后：

   复制

   export YNAB_ACCESS_TOKEN="your_token_here"
   

   或者使用 direnv 并与 .envrc：

   复制

   echo 'export YNAB_ACCESS_TOKEN="your_token_here"' > .envrc
   direnv allow
   

3. 运行服务器：

   复制

   uv run python main.py
   

   服务器运行于 http://localhost:8000/mcp

它能做什么？

该服务器提供了涵盖不同领域的21种工具：

• 账户列出账户，获取账户详情
• 类别查看和更新类别预算及备注
• 交易创建、读取、更新和删除交易
• **月（们）**查看预算月份详情
• 用户获取经过身份验证的用户信息

发展

运行代码检查工具直到没有错误：

ruff check --fix && basedpyright

注释

• 在YNAB（You Need A Budget，一个预算管理软件）中，所有金额均以“毫单位”（例如。， -50000 - 50.00美元
• 为了方便起见，大多数工具默认使用您上次使用的预算
• 使用……构建 FastMCP 以及 YNAB SDK（You Need A Budget 软件开发工具包）