Leafeye Lunchmoney MCP Server

🚀 午餐錢 MCP 服務器

午餐錢 MCP 服務器是一個模型上下文協議（MCP）服務器，它能讓您藉助 Claude 和其他 AI 助手，與 Lunchmoney 的交易和預算進行交互，為您的財務管理提供便利。

🚀 快速開始

在配置好服務器後，您可以在 Claude 桌面與服務器交互，提出關於交易和預算的相關問題，如“顯示我過去一週的近期交易”“顯示本月的預算概覽”等。

✨ 主要特性

此服務器提供了四個主要工具：

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

📦 安裝指南

通過 Smithery 安裝

要通過 Smithery 自動安裝 Lunchmoney MCP 服務器到 Claude 桌面，可使用以下命令：

npx -y @smithery/cli install @leafeye/lunchmoney-mcp-server --client claude

您也可以直接在 Claude 桌面上使用此服務器，無需安裝，按以下配置：

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

請將 your_token_here 替換為您的 Lunchmoney API 令牌，您可以在 您的 Lunchmoney 開發者設置 中獲取。

💻 使用示例

在 Claude 桌面配置完成後，您可以提出以下問題：

基礎用法

交易

• "顯示我過去一週的近期交易"
• "搜索所有亞馬遜交易"
• "上個月我在餐廳花了多少錢？"
• "查找標記為商務支出的交易"

預算

• "顯示本月的預算概覽"
• "2024 年 1 月至 3 月的預算狀態是什麼？"
• "我的食品預算是多少剩餘金額？"
• "顯示超出預算的類別"

📚 詳細文檔

什麼是 MCP？

模型上下文協議（MCP） 是一項開放協議，標準定義了應用程序如何向大型語言模型（LLMs）提供上下文。可以將其視為 AI 應用程序的 USB - C 端口——它為連接不同數據源和工具到 AI 模型提供了一種標準化方式。

MCP 的一些關鍵優勢：

• 標準化地將數據和功能暴露給大語言模型的方式
• 人機協作的安全性（所有操作都需要用戶批准）
• 不斷增長的現成集成生態系統
• 支持多種 AI 模型和應用程序

開發

要本地開發：

1. 克隆此倉庫
2. 安裝依賴：

npm install

3. 構建 TypeScript 代碼：

npm run build

4. 使用 API 令牌運行：

LUNCHMONEY_TOKEN=your_token_here node build/index.js

5. 使用 MCP Inspector 測試：

LUNCHMONEY_TOKEN=your_token_here npx @modelcontextprotocol/inspector node build/index.js

API 注意事項

• 預算數據必須使用月份邊界日期（例如，2024 - 01 - 01 到 2024 - 01 - 31）
• 交易可以使用任何日期範圍
• 所有貨幣值都以原始貨幣返回
• 類別名稱在搜索時大小寫不敏感

📄 許可證

本項目採用 MIT 許可證。

🤝 貢獻

歡迎貢獻！請隨意提交 Pull Request。