YNAB MCP服务器
用于将YNAB（你需要预算）与人工智能系统集成的模型上下文协议（MCP）服务器。该项目允许AI助手安全地访问和分析您的YNAB财务数据。
什么是MCP？
模型上下文协议（MCP）是一种标准，允许AI助手与外部工具和服务进行交互。它使像Claude这样的AI模型能够：
- 访问实时数据 超出训练截止日期
- 调用函数 在外部系统中
- 与API交互 安全地
- 提供上下文分析 基于您的个人数据
MCP允许AI处理您的特定信息，而不仅仅是基于常识进行回答。
关于YNAB MCP服务器
该项目在YNAB财务数据和人工智能助手之间建立了一座安全的桥梁。它允许您：
- 查询您的预算信息
- 分析支出模式
- 检查账户余额
- 跟踪财务目标
- 了解你的财务习惯
同时保持您的YNAB API代币的安全和您的财务数据的隐私。
特性
此MCP服务器实现了一套用于与YNAB API交互的综合工具：
用户和预算信息
GetUserInfo-检索您的YNAB用户IDListBudgets-在YNAB账户中获取所有预算GetBudgetDetails-关于特定预算的详细信息GetBudgetMonths-列出预算月份
类别和交易
ListCategories-预算中的所有类别GetCategoryDetails-关于类别的详细信息SearchTransactions-使用自定义筛选器查找交易ListAccountTransactions-获取特定账户的交易记录
账户和收款人
ListAccounts-将所有账户纳入预算ListPayees-将所有收款人纳入预算
财务分析
GetCurrentMonthSnapshot-当月预算汇总GetRecentActivitySummary-最近财务活动摘要GetIncomeVsExpenseSummary-比较一段时间内的收入和支出
入门指南
先决条件
- YNAB账户 具有API访问权限
- MCP兼容客户端（例如，桌面版的Claude）
- 要么：
- 码头工人 （用于Docker安装） - .NET 9 SDK （用于本地安装）
安装
通过Smithery安装
通过以下方式自动安装克劳德桌面版YNAB服务器 史密瑟里:
npx -y @smithery/cli install @ChuckBryan/ynabmcpserver --client claude点击以下按钮之一，在VS Code中自动安装YNAB MCP服务器：
这将：
- 配置VS代码以使用YNAB MCP服务器Docker镜像
- 需要时提示您输入YNAB API令牌
- 允许您使用F5或“运行”菜单启动服务器
安装后，您可以通过在VS Code中按F5或使用Run菜单启动服务器。提示时，输入YNAB API令牌，服务器将在Docker容器中自动启动。
可用环境变量
YNAB_API_TOKEN：您的YNAB API令牌（必需）
安全
此MCP服务器在您的机器上本地运行，不会与第三方共享您的YNAB API令牌。API令牌仅用于与YNAB API直接通信。
发展
项目结构
YnabMcpServer/
├── .vscode/ # VS Code configuration
├── docs/ # Documentation
├── requests/ # HTTP request samples for testing
├── scripts/ # Utility scripts
└── src/ # Source code
└── YnabMcpServer/ # Main project
├── Configuration/ # Configuration classes
├── Generated/ # Generated API client code
├── Services/ # Service implementations
├── Tools/ # MCP tool implementations
└── Program.cs # Application entry point扩展服务器
要添加新的MCP工具：
- 添加新方法
YnabTools.cs - 用
[McpServerTool]和[Description]属性 - 重建并重新启动服务器
贡献
欢迎投稿！请随时提交拉取请求。
许可证
此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。
版本控制和发布过程
此项目使用语义发布进行自动版本控制和发布。看 版本.md 有关提交消息格式和发布过程的详细信息。