MCP YNAB 服务器

一个 MCP 服务器实现，通过模型上下文协议提供对 YNAB (You Need A Budget) 功能的访问。

功能

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

安装

uv pip install -e .

配置

服务器需要一个 YNAB API 密钥才能运行。 您可以从您的 YNAB 开发者设置 获取一个。

API 密钥可以通过以下方式提供：

1. 环境变量：YNAB_API_KEY=your_api_key
2. MCP 密钥管理系统
3. 项目根目录中的 .env 文件

用法

运行服务器

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

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

可用资源

• ynab://accounts - 列出所有 YNAB 账户
• ynab://transactions/{account_id} - 获取特定账户的最近交易

可用工具

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

使用示例

# 创建新交易
result = await create_transaction(
    account_id="your_account_id",
    amount=42.50,  # 以美元为单位
    payee_name="Coffee Shop",
    category_name="Dining Out",
    memo="Morning coffee"
)

# 获取账户余额
balance = await get_account_balance("your_account_id")

# 列出账户
accounts = await ctx.read_resource("ynab://accounts")

# 获取最近交易
transactions = await ctx.read_resource(f"ynab://transactions/{account_id}")

开发

# 安装依赖 (使用 uv)
task deps

# 运行所有测试，包括集成测试 (您需要一个 YNAB API 密钥)
task test:all

# 生成覆盖率报告
task coverage

# 格式化和检查代码
task fmt  # 应该将此添加到 Taskfile

项目任务

此项目使用 Taskfile 进行常见操作。 主要命令：

task dev       # 启动带有自动重载的开发服务器
task test      # 运行单元测试
task coverage  # 生成测试覆盖率报告
task install   # 安装生产版本
task deps      # 同步依赖

有关所有可用任务，请参见 Taskfile.yml。