MCP YNAB Server

MCP YNAB Server

site icon
2025.02.26 2
Python个人财务管理预算跟踪交易记录管理金融服务
MCP YNAB Server 是一个基于 Model Context Protocol (MCP) 的服务实现,提供对 YNAB (You Need A Budget) 功能的访问。该服务允许用户查看账户余额和交易记录,创建新交易,并通过标准化的 MCP 资源访问 YNAB 数据。
View on GitHub

Overview

基本能力

产品定位

MCP YNAB Server 是一个金融服务工具,专注于个人财务管理,通过 MCP 协议提供对 YNAB 功能的访问。

核心功能

  • 查看账户余额和交易记录
  • 创建新交易
  • 通过标准化的 MCP 资源访问 YNAB 数据

适用场景

  • 个人财务管理
  • 预算跟踪
  • 交易记录管理

工具列表

  • create_transaction - 创建新交易
  • get_account_balance - 获取账户当前余额

常见问题解答

  1. 如何获取 YNAB API 密钥?
  2. 可以从 YNAB Developer Settings 获取。
  3. 如何提供 API 密钥?
  4. 通过环境变量 YNAB_API_KEY=your_api_key
  5. 通过 MCP 密钥管理系统
  6. 通过项目根目录下的 .env 文件

使用教程

使用依赖

无特殊依赖,安装前确保已安装 uv

安装教程

uv pip install -e .

调试方式

# 开发模式,带热重载和浏览器启动
task dev

# 生产安装,适用于 Claude Desktop, Goose 或其他 MCP 支持的环境
task install

运行测试

# 运行所有测试(需要 YNAB API 密钥)
task test:all

# 生成测试覆盖率报告
task coverage

许可证

None