py-ynab-mcp
A. 模型上下文协议 服务器 YNAB(你需要预算).与Claude、Cursor或任何MCP客户讨论您的预算。
特性
- 查询预算、账户、类别、交易、收款人和月份
- 获取单一资源详细信息(账户、类别、收款人、交易)
- 创建、更新和删除事务(单笔和批量)
- 更新类别预算和元数据
- 重命名收款人
- 管理计划事务(完整CRUD)
- 预算设置和用户信息
安装
uvx py-ynab-mcp或者使用pip:
pip install py-ynab-mcp设置
- 买一个YNAB 个人访问令牌
- 添加到MCP客户端配置中:
{
"mcpServers": {
"ynab": {
"command": "uvx",
"args": ["py-ynab-mcp"],
"env": {
"YNAB_ACCESS_TOKEN": "your-token-here"
}
}
}
}为什么是这个项目?
有几个YNAB MCP服务器:
| 项目 | 语言 | 许可证 |
|---|---|---|
| calebl/ynab mcp服务器 | TypeScript | 麻省理工学院 |
| 马特维格/ynab mcp | JavaScript | 麻省理工学院 |
| chrisguidry/你需要一个mcp | Python | 无许可证 |
| py-ynab-mcp | Python | 麻省理工学院 |
我们想要一个拥有完整API覆盖范围和全面测试覆盖范围的MIT-licensed Python实现。在撰写本文时,唯一的Python选项没有OSS许可证,所以我们构建了这个选项。
YNAB API覆盖范围
阅读
- 用户信息、预算设置
- 预算、账户、类别、收款人、月份(列表和单个)
- 按账户、类别或收款人过滤的交易
- 计划交易(列表和单个)
写
- 创建、更新、删除交易(单笔和批量)
- 更新类别预算和元数据
- 重命名收款人
- 创建、更新、删除计划交易
在YNAB API中不可用
- 创建/删除预算、类别或帐户
- 创建/删除收款人(通过交易自动创建)
- 事务处理导入
发展
# Clone and install
git clone https://github.com/duganth/py-ynab-mcp.git
cd py-ynab-mcp
uv sync
# Run tests
uv run pytest
# Lint and type check
uv run ruff check .
uv run mypy src/许可证
麻省理工学院
