Lunchmoney MCP Server 使用说明

项目简介

Lunchmoney MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器应用，它充当桥梁，将你的 Lunchmoney 财务数据连接到像 Claude 这样的大型语言模型 (LLM)。通过这个服务器，你可以使用自然语言与 AI 助手对话，轻松查询你的消费记录、分析预算状况，并获得更深入的财务洞见。

主要功能点

获取近期交易记录 (get-recent-transactions): 快速查看最近一段时间内的交易明细，例如过去 N 天的消费记录。
搜索交易记录 (search-transactions): 根据关键词在交易的收款方名称或备注信息中搜索特定的交易记录。
获取分类消费 (get-category-spending): 分析在特定消费类别下的支出情况，帮助你了解资金流向。
获取预算总结 (get-budget-summary): 获取指定时间段内的预算执行情况总结，包括预算分配、实际支出、剩余预算以及周期性预算项目等信息。

安装步骤

安装 Node.js: 确保你的电脑上已经安装了 Node.js 运行环境。你可以从 Node.js 官网下载并安装适合你操作系统的版本。
获取 Lunchmoney API Token: 访问 Lunchmoney 开发者设置页面，创建并获取你的 API 访问令牌。
配置 Claude 客户端:
- 打开 Claude 桌面应用程序。
- 进入 "Settings"（设置） -> "Developer"（开发者） -> "Edit Config"（编辑配置）。
- 在打开的配置文件中，添加以下 JSON 配置代码块。请将 'your_token_here' 替换为你刚刚获取的 Lunchmoney API 令牌。

服务器配置

以下是将 Lunchmoney MCP Server 配置到 Claude 客户端的 JSON 代码。这段配置告诉 Claude 如何启动和连接到 Lunchmoney MCP Server。

{
  "mcpServers": {
    "lunchmoney": {
      "command": "npx",
      "args": ["-y", "lunchmoney-mcp-server"],
      "env": {
        "LUNCHMONEY_TOKEN": "your_token_here" // 请替换为你的 Lunchmoney API Token
      }
    }
  }
}

配置参数说明:

'"lunchmoney"': 自定义的服务器名称，在 Claude 中用于标识 Lunchmoney MCP Server。
'"command": "npx"': 指定用于启动服务器的命令为 'npx'，它会自动查找并执行 'lunchmoney-mcp-server' 包。
'"args": ["-y", "lunchmoney-mcp-server"]': 传递给 'npx' 命令的参数，'-y' 表示自动确认安装 'lunchmoney-mcp-server' 包（如果尚未安装），'lunchmoney-mcp-server' 是要执行的包名称。
'"env": { "LUNCHMONEY_TOKEN": "your_token_here" }': 设置环境变量，'LUNCHMONEY_TOKEN' 用于存储你的 Lunchmoney API 令牌，服务器程序会读取这个环境变量来访问你的 Lunchmoney 数据。 请务必将 '"your_token_here"' 替换为你实际的 API 令牌。

重要提示: 修改 Claude 配置文件后，可能需要重启 Claude 桌面应用才能使配置生效。

基本使用方法

完成配置后，在 Claude 中开始与 AI 助手的对话。你可以使用自然语言提出关于你的 Lunchmoney 财务数据的问题。以下是一些示例：

交易查询:

"Show me my recent transactions from the past week" (显示我最近一周的交易记录)
"Search for all transactions at Amazon" (搜索所有在亚马逊的交易记录)
"How much did I spend on restaurants last month?" (上个月我在餐馆消费了多少？)
"Find transactions tagged as business expenses" (查找标记为商务支出的交易记录)

预算查询:

"Show me my budget summary for this month" (显示我本月的预算总结)
"What's my budget status from January to March 2024?" (2024年1月到3月的预算状况如何？)
"How much of my food budget is remaining?" (我的食品预算还剩多少？)
"Show me categories where I'm over budget" (显示哪些类别的预算超支了？)

请注意，首次使用时，Claude 可能会请求你授权 Lunchmoney MCP Server 访问你的 Lunchmoney 数据。请根据提示进行授权。

关键词