Lunchmoney MCP

🚀 Lunch Money MCP 服務器

這是一個用於 Lunch Money API 的 MCP（模型上下文協議）服務器，它允許人工智能助手與你的 Lunch Money 賬戶進行交互，以管理交易、類別、預算等。

✨ 主要特性

此 MCP 服務器提供對 Lunch Money 以下功能的訪問：

• 用戶：獲取賬戶信息
• 類別：創建、讀取、更新和刪除類別
• 交易：管理交易（創建、讀取、更新、過濾）
• 標籤：獲取所有標籤
• 資產：管理賬戶/資產
• 預算：獲取和更新預算
• 定期項目：獲取定期交易
• Plaid 賬戶：管理連接的 Plaid 賬戶
• 加密貨幣：管理加密資產

📦 安裝指南

選項 1：自動安裝（更簡單）🚀

python install.py

此腳本將：

• ✅ 自動安裝軟件包
• ✅ 詢問你的 Lunch Money 令牌
• ✅ 自動配置 Claude Desktop
• ✅ 一切準備就緒，可直接使用

選項 2：手動安裝

pip install lunchmoney-mcp

然後將以下配置添加到你的 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "lunchmoney": {
      "command": "lunchmoney-mcp",
      "env": {
        "LUNCHMONEY_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

就這麼簡單！ 🎉 和 Playwright MCP 一樣容易。

獲取訪問令牌：

1. 訪問 https://my.lunchmoney.app/developers
2. 創建一個新的訪問令牌
3. 在上述配置中使用它

從源代碼安裝

如果你更喜歡從源代碼安裝：

1. 克隆倉庫：

   git clone <repository-url>
   cd lunchmoney-mcp
   

2. 安裝：

   pip install -e .
   

3. 在 Claude Desktop 中配置：

   {
     "mcpServers": {
       "lunchmoney": {
         "command": "lunchmoney-mcp",
         "env": {
           "LUNCHMONEY_ACCESS_TOKEN": "your_token_here"
         }
       }
     }
   }
   

配置文件位置：

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

💻 使用示例

配置完成後，你可以使用 Claude Desktop 與你的 Lunch Money 賬戶進行交互。以下是一些使用示例：

基礎用法

1. 獲取用戶信息：

   "顯示我的 Lunch Money 賬戶信息"
   

2. 查看所有類別：

   "列出我所有的 Lunch Money 類別"
   

3. 創建新類別：

   "在 Lunch Money 中創建一個名為 '娛樂' 的新類別"
   

4. 查看近期交易：

   "顯示上個月的交易記錄"
   

5. 創建交易：

   "為 'XYZ 超市' 添加一筆 50 美元的交易，類別為 '食品'"
   

6. 查看預算：

   "顯示本月的預算摘要"
   

📚 詳細文檔

可用工具

用戶

• get_user：獲取用戶和賬戶信息

類別

• get_all_categories：獲取所有類別
• get_single_category：獲取特定類別
• create_category：創建新類別
• update_category：更新現有類別
• delete_category：刪除類別

交易

• get_all_transactions：獲取所有交易（帶過濾器）
• get_single_transaction：獲取特定交易
• insert_transactions：插入新交易
• update_transaction：更新現有交易

標籤

• get_all_tags：獲取所有標籤

資產

• get_all_assets：獲取所有資產/賬戶
• create_asset：創建新資產/賬戶
• update_asset：更新現有資產

預算

• get_budget_summary：獲取預算摘要
• upsert_budget：創建或更新預算數據

定期項目

• get_recurring_items：獲取所有定期項目

Plaid 賬戶

• get_all_plaid_accounts：獲取所有 Plaid 賬戶
• trigger_plaid_fetch：觸發與 Plaid 的同步

加密貨幣

• get_all_crypto：獲取所有加密資產
• update_manual_crypto：手動更新加密資產

🔧 技術細節

開發

若要為開發做出貢獻：

1. 安裝開發依賴項：

   pip install -e ".[dev]"
   

2. 運行測試：

   pytest
   

3. 格式化代碼：

   black lunchmoney_mcp/
   

安全

• 切勿分享你的 Lunch Money 訪問令牌
• 將令牌保存在 .env 文件中，並確保該文件在 .gitignore 中
• MCP 服務器在本地運行，不會將數據發送到外部服務

限制

• Lunch Money API 處於公開測試階段，可能會有變更
• 某些操作可能有速率限制
• 通過 API 進行的更改不可逆轉

支持

如果你遇到問題：

1. 驗證你的訪問令牌是否有效
2. 查閱 Lunch Money 官方文檔
3. 檢查 MCP 服務器日誌以獲取特定錯誤信息

📄 許可證

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

相關鏈接

• Lunch Money
• Lunch Money API 文檔
• 模型上下文協議
• Claude Desktop