MCP Ynab Server

🚀 MCP YNAB 服務器

MCP YNAB 服務器是一個通過模型上下文協議（Model Context Protocol）提供 YNAB（You Need A Budget）功能訪問的實現方案。它能夠幫助用戶更便捷地訪問和管理 YNAB 的相關數據，提升財務管理的效率。

🚀 快速開始

MCP YNAB 服務器可讓你通過模型上下文協議訪問 YNAB 的功能。在使用前，你需要安裝並配置該服務器。

✨ 主要特性

• 支持查看賬戶餘額和交易記錄，讓你清晰掌握財務狀況。
• 能夠創建新交易，方便記錄每一筆收支。
• 通過標準化的 MCP 資源訪問 YNAB 數據，確保數據交互的規範性和高效性。

📦 安裝指南

uv pip install -e .

💻 使用示例

基礎用法

# 創建一個新交易
result = await create_transaction(
    account_id="your_account_id",
    amount=42.50,  # 美元金額
    payee_name="Coffee Shop",
    category_name="Dining Out",
    memo="Morning coffee"
)

# 獲取賬戶餘額
balance = await get_account_balance("your_account_id")

# 列出賬戶
accounts = await ctx.read_resource("ynab://accounts")

# 獲取近期交易
transactions = await ctx.read_resource(f"ynab://transactions/{account_id}")

高級用法

# 開發模式，帶熱重載和瀏覽器啟動
task dev

# 生產安裝，適用於Claude Desktop、Goose或其他支持MCP的環境
task install

📚 詳細文檔

配置說明

該服務器需要一個 YNAB API 密鑰才能運行。可以從您的YNAB 開發者設置獲取。

API 密鑰可以通過以下方式提供：

1. 環境變量：YNAB_API_KEY=your_api_key
2. MCP 秘密管理系統
3. 項目根目錄中的.env文件

可用資源

• ynab://accounts - 列出所有 YNAB 賬戶
• ynab://transactions/{account_id} - 獲取特定賬戶的近期交易

可用工具

• create_transaction - 創建新交易
• get_account_balance - 獲取賬戶當前餘額

開發相關

# 安裝依賴（使用uv）
task deps

# 運行所有測試，包括集成測試（需要YNAB API密鑰）
task test:all

# 生成覆蓋報告
task coverage

# 格式化和檢查代碼
task fmt  # 應將此添加到Taskfile中

項目任務

該項目使用 Taskfile 來管理常見操作。關鍵命令包括：

task dev       # 運行開發服務器，帶自動重新加載
task test      # 運行單元測試
task coverage  # 生成測試覆蓋報告
task install   # 安裝生產版本
task deps      # 同步依賴項

查看Taskfile.yml以獲取所有可用任務。