MCP 预算助手服务器 💰

欢迎来到 YNAB（TypeScript 版本）的 MCP 服务器！🎉 这个项目允许你将 Cursor（或其他 MCP 客户端）连接到你的 You Need A Budget (YNAB) 账户，直接从你的编辑器中与你的财务数据交互。

1. 这是什么？ 🤔 （目的）

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

2. 提供的工具 🛠️

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

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

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

3. 设置 🚀

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
   

4. 使用说明

启用 MCP 服务器

在 Cursor 中启用 MCP 服务器：

1. 打开 config.json 文件。
2. 添加以下配置：

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

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

调用工具

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

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

5. 开发信息