Ynab MCP

🚀 YNAB MCP Server

這是一個用於與“你需要一個預算”（YNAB）無縫集成的模型上下文協議（MCP）服務器。該服務器使人工智能助手能夠與你的YNAB預算進行交互，提供強大的自動化和分析功能。

🚀 快速開始

快速安裝（Claude桌面端）

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "uvx",
      "args": ["ynab-mcp-server"],
      "env": {
        "YNAB_PAT": "your_token_here",
      }
    }
  }
}

可選環境變量：

"env": {
  "YNAB_DEFAULT_BUDGET_ID": "your_budget_id",
  "YNAB_READ_ONLY": "true"
}

✨ 主要特性

• 全面的預算管理

  • 查看和管理多個預算
  • 跟蹤賬戶餘額和交易
  • 監控類別支出和目標

• 交易控制

  • 列出和搜索交易
  • 更新交易細節
  • 管理收款人和類別

• 財務分析

  • 獲取全面的財務概況
  • 跟蹤消費模式
  • 監控預算進度

📦 安裝指南

使用uvx時無需安裝

# 直接運行（推薦）
uvx ynab-mcp-server

# 或者使用特定版本
uvx ynab-mcp-server@0.1.1

開發環境

# 從源代碼克隆並運行
git clone https://github.com/yourusername/ynab-mcp-server.git
cd ynab-mcp-server
uv run ynab-mcp-server

📚 詳細文檔

特定平臺設置

Claude桌面端

1. 找到你的配置文件：
   • MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%/Claude/claude_desktop_config.json
   • Linux：~/.config/Claude/claude_desktop_config.json
2. 添加YNAB MCP服務器配置：

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "uvx",
      "args": ["ynab-mcp-server"],
      "env": {
        "YNAB_PAT": "your_token_here"
      }
    }
  }
}

可選環境變量：

env: {
  "YNAB_DEFAULT_BUDGET_ID": "your_budget_id",
  "YNAB_READ_ONLY": "true"
}

Goose

1. 打開Goose設置
2. 導航到MCP服務器部分
3. 添加一個新服務器，設置如下：
   • 名稱：ynab-mcp
   • 命令：uvx ynab-mcp-server
   • 環境變量：
     • YNAB_PAT: your_token_here

其他平臺

對於其他支持MCP的平臺，使用以下參數進行配置：

• 服務器名稱：ynab-mcp
• 命令：uvx
• 參數：ynab-mcp-server
• 必需環境變量：YNAB_PAT

配置

你的服務器可以使用環境變量進行配置。你可以將這些變量放在項目根目錄的.env文件中，或者在你的shell中設置它們。

獲取你的YNAB令牌

1. 獲取你的YNAB令牌
   • 訪問YNAB開發者設置
   • 創建一個新的個人訪問令牌
   • 複製令牌值
2. 設置環境變量 創建一個.env文件在你的工作目錄中：

YNAB_PAT="your_token_here"
YNAB_DEFAULT_BUDGET_ID="your_budget_id"
YNAB_READ_ONLY="true"

或者直接設置環境變量：

export YNAB_PAT="your_token_here"

可用工具

服務器提供了一套與你的YNAB數據進行交互的工具。以下描述解釋了每個工具的用途和推薦用法。

開發

本地設置

1. 克隆倉庫：

git clone https://github.com/yourusername/ynab-mcp-server.git
cd ynab-mcp-server

2. 安裝依賴：

uv sync

3. 運行服務器：

uv run ynab-mcp-server

調試

使用MCP檢查器進行調試：

npx @modelcontextprotocol/inspector uvx ynab-mcp-server

對於本地開發調試：

cd path/to/ynab-mcp-server
npx @modelcontextprotocol/inspector uv run ynab-mcp-server

你還可以查看日誌：

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

構建和發佈

# 構建包
uv build

# 發佈到PyPI
uv publish

貢獻代碼

歡迎貢獻代碼！你可以按照以下步驟進行：

1. 分叉倉庫
2. 創建一個功能分支 (git checkout -b feature/amazing-feature)
3. 提交你的更改 (git commit -m 'Add amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打開一個拉取請求

請確保你的拉取請求：

• 遵循現有的代碼風格
• 包含適當的測試
• 根據需要更新文檔

📄 許可證

本項目採用MIT許可證 - 有關詳細信息，請參閱LICENSE文件。

致謝

• YNAB API 提供核心功能
• Model Context Protocol 支持AI助手集成