STARWARCLOUD STARWAR.AI
返回市场
云核算MCP服务器

云核算MCP服务器

作者：ChuckBryan11 星标更新：2025-05-16
安装使用来源：spider==github.com

项目介绍

YNAB MCP Server

用于将YNAB（You Need A Budget）与AI系统集成的模型上下文协议（MCP）服务器。此项目允许AI助手安全地访问并分析您的YNAB财务数据。

构建 Docker镜像 平台 smithery徽章

什么是MCP？

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

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

MCP不仅让AI根据通用知识回答问题，还能让AI处理您的特定信息。

关于YNAB MCP Server

这个项目创建了一个安全的桥梁，连接您的YNAB财务数据和AI助手。它允许您：

  • 查询预算信息
  • 分析消费模式
  • 检查账户余额
  • 跟踪财务目标
  • 获取关于您的财务习惯的见解

同时确保您的YNAB API令牌安全且您的财务数据私密。

特性

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

用户和预算信息

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

类别和交易

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

账户和收款人

  • ListAccounts - 获取预算中的所有账户
  • ListPayees - 获取预算中的所有收款人

财务分析

  • GetCurrentMonthSnapshot - 当月预算概要
  • GetRecentActivitySummary - 最近财务活动概要
  • GetIncomeVsExpenseSummary - 收入与支出对比概要

开始使用

预备条件

  • 具有API访问权限的YNAB账户
  • 一个兼容MCP的客户端（例如，桌面版Claude）
  • 以下之一：

安装

通过Smithery安装

要通过Smithery自动安装Claude Desktop的YNAB服务器：

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

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

[在VS Code中安装](vscode://ms-vscode.mcp/install?url=https://raw.githubusercontent.com/ChuckB Bryan/ynabmcpserver/main/mcp-manifest.json) 在VS Code Insiders中安装

这将：

  1. 配置VS Code以使用YNAB MCP Server Docker镜像
  2. 在需要时提示您输入YNAB API令牌
  3. 允许您通过F5或运行菜单启动服务器

安装后，您可以通过在VS Code中按F5或使用运行菜单来启动服务器。当提示时，输入您的YNAB API令牌，服务器将在Docker容器中自动启动。

可用环境变量

  • YNAB_API_TOKEN：您的YNAB API令牌（必需）

安全性

此MCP服务器在您的机器上本地运行，并不与第三方共享您的YNAB API令牌。API令牌仅用于直接与YNAB API通信。

开发

项目结构

YnabMcpServer/
├── .vscode/            # VS Code配置
├── docs/               # 文档
├── requests/           # 测试用HTTP请求样本
├── scripts/            # 实用脚本
└── src/                # 源代码
    └── YnabMcpServer/  # 主项目
        ├── Configuration/ # 配置类
        ├── Generated/     # 生成的API客户端代码
        ├── Services/      # 服务实现
        ├── Tools/         # MCP工具实现
        └── Program.cs     # 应用程序入口点

扩展服务器

要添加新的MCP工具：

  1. 在YnabTools.cs中添加新方法
  2. 使用[McpServerTool]和[Description]属性装饰它们
  3. 重新构建并重启服务器

贡献

欢迎贡献！请随时提交Pull Request。

许可证

此项目采用MIT许可证 - 详情见LICENSE文件。

版本控制和发布流程

此项目使用semantic-release进行自动化版本控制和发布。有关提交消息格式和发布流程的详细信息，请参阅VERSIONING.md。

致谢