Lunchmoney MCP Server

🚀 午餐錢 MCP 服務器

午餐錢 MCP 服務器是一個基於模型上下文協議（MCP）的工具，它藉助 Claude 等 AI 助手，實現與 Lunchmoney（https://lunchmoney.app）進行交易和預算交互，讓你能以自然對話的方式輕鬆管理財務數據。

🚀 快速開始

此工具可將你的 Lunchmoney 財務數據與 Claude AI 相連接，你能通過自然對話詢問支出情況、分析預算並獲取財務見解。

✨ 主要特性

此服務器具備四個主要功能：

1. 獲取最近交易：可查看過去 N 天的最近交易記錄。
2. 搜索交易：能按付款人名稱或備註中的關鍵字搜索交易。
3. 分類別支出：可分析特定類別的支出狀況。
4. 預算概覽：能獲取詳細的預算信息，涵蓋支出、剩餘金額和重複項目。

⚠️ 重要提示

⚠️ 重要提示

MCP 提供一種結構化的方式，讓 Claude 與你的 Lunchmoney 數據交互，同時保持隱私邊界。以下是需要注意的事項：

• Claude（宿主）創建一個客戶端連接到你本地的 MCP 服務器。
• 你的 Lunchmoney API 令牌保留在你的本地機器上。
• MCP 服務器在本地運行，並從 Lunchmoney 的 API 獲取數據。
• 每次請求訪問你的 Lunchmoney 數據時，都會提示你批准。
• 當你詢問有關財務的問題時，Claude 會請求特定信息來自 MCP 服務器。
• MCP 服務器在本地處理你的請求，並僅返回相關結果。
• Claude 從未直接訪問你的完整財務數據或 API 令牌。
• 只有請求的特定信息（如交易摘要或預算狀態）才會與 Claude 共享。
• Anthropic 的數據保留策略適用於這些摘要結果，作為你對話的一部分。
• 每個服務器連接都是隔離的，保持清晰的安全邊界。

你可以在文檔中找到更多關於 MCP 的信息：https://modelcontextprotocol.io/introduction

📦 安裝指南

也請查閱官方 Claude 文檔：https://modelcontextprotocol.io/quickstart/user

使用 npx

Node.js 是一個讓你在計算機上（不在 Web 瀏覽器中）運行 JavaScript 代碼的軟件平臺。

安裝 Node.js：

• Windows/Mac：從官方 Node.js 網站下載並運行安裝程序。
• Mac with Homebrew：在終端中運行brew install node。
• Linux：使用你的包管理器（例如 Ubuntu 的sudo apt install nodejs）。

安裝完成後，你可以直接通過運行服務器而不必下載任何內容：

1. 從你的Lunchmoney 開發者設置獲取 Lunchmoney API 令牌。
2. 打開 Claude Desktop。
3. 轉到設置 → 開發者 → 編輯配置。
4. 添加以下配置：

{
  "mcpServers": {
    "lunchmoney": {
      "command": "npx",
      "args": ["-y", "lunchmoney-mcp-server"],
      "env": {
        "LUNCHMONEY_TOKEN": "your_token_here"
      }
    }
  }
}

將your_token_here替換為你的實際 Lunchmoney API 令牌。

⚠️ 重要提示

更改配置後，可能需要重新啟動 Claude 才能應用更改。

💻 使用示例

基礎用法

• 獲取最近交易：發送請求到 MCP 服務器以獲取過去 7 天的交易記錄。
• 搜索交易：通過指定關鍵字或類別來篩選特定交易。
• 分類別支出：分析不同類別的總支出金額。
• 預算概覽：檢查每個預算項目的當前剩餘金額和使用情況。

📚 詳細文檔

你可以在文檔中找到更多關於 MCP 的信息：https://modelcontextprotocol.io/introduction

📄 許可證

本項目採用 MIT 許可證。

貢獻指南

歡迎貢獻！請隨時提交拉取請求。