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

📚 詳細文檔

開發信息