AI导哈

YNAB财务数据集成服务

一个用于将YNAB（You Need A Budget）与AI系统集成的模型上下文协议（MCP）服务器，允许AI助手安全访问和分析用户的YNAB财务数据。

  • by ChuckBryan
  • C#
  • 本地部署
  • 13 星标
  • 更新于
在 GitHub 查看 ChuckBryan/ynabmcpserver

使用说明

YNAB MCP服务器

用于将YNAB（你需要预算）与人工智能系统集成的模型上下文协议（MCP）服务器。该项目允许AI助手安全地访问和分析您的YNAB财务数据。

什么是MCP？

模型上下文协议（MCP）是一种标准，允许AI助手与外部工具和服务进行交互。它使像Claude这样的AI模型能够：

  1. 访问实时数据 超出训练截止日期
  2. 调用函数 在外部系统中
  3. 与API交互 安全地
  4. 提供上下文分析 基于您的个人数据

MCP允许AI处理您的特定信息，而不仅仅是基于常识进行回答。

关于YNAB MCP服务器

该项目在YNAB财务数据和人工智能助手之间建立了一座安全的桥梁。它允许您：

  • 查询您的预算信息
  • 分析支出模式
  • 检查账户余额
  • 跟踪财务目标
  • 了解你的财务习惯

同时保持您的YNAB API代币的安全和您的财务数据的隐私。

特性

此MCP服务器实现了一套用于与YNAB API交互的综合工具：

用户和预算信息

  • GetUserInfo -检索您的YNAB用户ID
  • ListBudgets -在YNAB账户中获取所有预算
  • GetBudgetDetails -关于特定预算的详细信息
  • GetBudgetMonths -列出预算月份

类别和交易

  • ListCategories -预算中的所有类别
  • GetCategoryDetails -关于类别的详细信息
  • SearchTransactions -使用自定义筛选器查找交易
  • ListAccountTransactions -获取特定账户的交易记录

账户和收款人

  • ListAccounts -将所有账户纳入预算
  • ListPayees -将所有收款人纳入预算

财务分析

  • GetCurrentMonthSnapshot -当月预算汇总
  • GetRecentActivitySummary -最近财务活动摘要
  • GetIncomeVsExpenseSummary -比较一段时间内的收入和支出

入门指南

先决条件

  • YNAB账户 具有API访问权限
  • MCP兼容客户端（例如，桌面版的Claude）
  • 要么：

安装

通过Smithery安装

通过以下方式自动安装克劳德桌面版YNAB服务器 史密瑟里:

npx -y @smithery/cli install @ChuckBryan/ynabmcpserver --client claude

点击以下按钮之一，在VS Code中自动安装YNAB MCP服务器：

这将：

  1. 配置VS代码以使用YNAB MCP服务器Docker镜像
  2. 需要时提示您输入YNAB API令牌
  3. 允许您使用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工具：

  1. 添加新方法 YnabTools.cs
  2. 用 [McpServerTool] 和 [Description] 属性
  3. 重建并重新启动服务器

贡献

欢迎投稿！请随时提交拉取请求。

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

版本控制和发布过程

此项目使用语义发布进行自动版本控制和发布。看 版本.md 有关提交消息格式和发布过程的详细信息。

致谢

相关 MCP