AI导哈

预算管理协议服务器

一个用于YNAB预算管理的最小化、可审计的MCP服务器，适用于需要读取和修改YNAB预算的本地AI助手。

  • by WGDevelopment
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 wg-whm/ynab-mcp-server

使用说明

YNAB MCP服务器

用于YNAB预算管理的最小、可审计的MCP（模型上下文协议）服务器。专为需要阅读和修改YNAB预算的本地AI助手而设计。

为什么存在

使用本地LLM进行财务指导，同时将敏感的上下文（目标、推理、生活环境）从云服务器中删除。只有结构化的API命令才能进入YNAB。

特性

  • 阅读：预算、账户、类别、交易、收款人
  • 写：创建交易，在类别之间转移资金
  • 安全：令牌存储在操作系统密钥环中，从未记录或传输到其他地方

安装

git clone https://github.com/wg-whm/ynab-mcp-server.git
cd ynab-mcp-server
pip install .

或者使用紫外线：

uv pip install .

设置

  1. 在以下网址获取YNAB个人访问令牌https://app.youneedabudget.com/settings/developer

  2. 存储令牌：

# Option A: OS keyring (recommended)
ynab-mcp store-token

# Option B: Environment variable
export YNAB_API_TOKEN="your-token-here"
  1. 验证：
ynab-mcp check-token

用法

使用Claude Code/MCP客户端

添加到MCP配置中：

{
  "mcpServers": {
    "ynab": {
      "command": "ynab-mcp"
    }
  }
}

直接

ynab-mcp run

可用工具

工具 描述 修改数据
ynab_get_budgets 列出所有预算 否
ynab_get_accounts 列出有余额的账户 否
ynab_get_categories 列出已预算/已支出/可用的类别 否
ynab_get_transactions 列出交易记录（可筛选） 否
ynab_get_month_summary 带有超速警告的月份概览 否
ynab_get_payees 列出所有收款人 否
ynab_move_money 在不同类别之间转移资金 是
ynab_create_transaction 创建新交易 是
ynab_update_transaction 更新现有交易 是

安全

当地特色：

  • 你的目标和动机
  • 人工智能辅导响应
  • 对话历史
  • 你分享的生活背景

进入YNAB API的内容：

  • 结构化API调用（获取类别、创建事务等）
  • YNAB已经拥有相同的数据

审核要点：

  • src/ynab_mcp_server/api.py -所有API通信（约300条线路）
  • 唯一端点： https://api.ynab.com/v1
  • 从keyring/env检索到的令牌，从未记录

许可证

麻省理工学院

相关 MCP