mcp-ynab

🚀 MCP 预算助手服务器 💰

这个项目允许你将 Cursor（或其他 MCP 客户端）连接到你的 You Need A Budget (YNAB) 账户，直接从你的编辑器中与你的财务数据交互。它就像一座桥梁，让你在 MCP 兼容环境中轻松处理财务问题。

🚀 快速开始

这是一个基于 模型上下文协议 (MCP) 的 TypeScript 实现，作为 YNAB 官方 API 的桥梁。目标是为 MCP 兼容环境提供标准化工具，以便从 AI 助手（如 Cursor）读取和写入 YNAB 数据，帮助你处理财务问题。

✨ 主要特性

此服务器提供了以下工具，每个工具都有详细的文档：

• listBudgets：列出你的可用预算。
• listAccounts：在指定预算中列出账户。
• getAccountBalance：获取特定账户的当前余额。
• listCategories：在指定预算中列出类别。
• getCategoryInfo：获取特定月份某个类别的详细信息。
• getBudgetSummary：为特定月份提供预算摘要（收入、预算金额、活动）。
• listTransactions：列出预算的交易，带有过滤选项（按账户、类别、日期等）。
• createTransaction：在预算中创建新的交易或分录。

查看每个工具的 README.md 以获取详细信息，包括参数、输出和使用上下文。

📦 安装指南

1. 克隆仓库：

   # 如果你还没有克隆过
   git clone https://github.com/Bulletninja/mcp-ynab
   cd mcp-ynab
   

2. 安装依赖项：

   npm install
   

3. 配置 YNAB API 令牌：
   • 在 config.json 文件中添加你的 YNAB API 令牌：

     {
       "ynabToken": "your_ynab_api_token_here"
     }
     

4. 启动服务器：

   npm start
   

💻 使用示例

启用 MCP 服务器

在 Cursor 中启用 MCP 服务器：

{
  "mcpServers": [
    {
      "name": "YNAB",
      "executablePath": "dist/server.js"
    }
  ]
}

启动 Cursor，服务器将在后台运行。

调用工具

在终端中输入以下命令来调用工具：

node dist/server.js [tool名]
例如：
node dist/server.js list-budgets

📚 详细文档

开发信息