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 许可证。

贡献指南

欢迎贡献！请随时提交拉取请求。