Lunchmoney MCP 服务器

一个模型上下文协议 (MCP) 服务器，让您可以通过 Claude 和其他 AI 助手与您的 Lunchmoney 交易和预算进行交互。

这是什么？

此工具允许您将 Lunchmoney 财务数据连接到 Claude AI，以便您可以通过自然对话提出有关您的支出的问题、分析您的预算并获得有关您财务的见解。

功能

此服务器提供四个主要工具：

1. get-recent-transactions: 查看过去 N 天的近期交易
2. search-transactions: 按收款人姓名或备注中的关键字搜索交易
3. get-category-spending: 分析特定类别的支出
4. get-budget-summary: 获取详细的预算信息，包括支出、剩余金额和经常性项目

隐私和数据处理

重要提示： 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 网站 下载并运行安装程序
• 使用 Homebrew 的 Mac: 在终端中运行 brew install node
• Linux: 使用您的软件包管理器（例如，Ubuntu 的 sudo apt install nodejs）

在您的计算机上安装 Node.js 后，您可以直接运行服务器，而无需下载任何内容：

1. 从您的 Lunchmoney 开发者设置 获取您的 Lunchmoney API 令牌
2. 打开 Claude Desktop
3. 转到 Settings → Developer -> Edit Config
4. 添加以下配置：

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

将 your_token_here 替换为您的实际 Lunchmoney API 令牌。

重要提示： 更改配置后，您可能需要重新启动 Claude Desktop 才能使更改生效。

使用示例

在 Claude Desktop 中配置后，您可以提出如下问题：

交易

• "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" (显示我超出预算的类别)

什么是 MCP？

模型上下文协议 (MCP) 是一个开放协议，用于标准化应用程序如何向大型语言模型 (LLM) 提供上下文。可以将 MCP 视为 AI 应用程序的 USB-C 端口 - 它提供了一种标准化的方式来将 AI 模型连接到不同的数据源和工具。

MCP 的一些主要优势：

• 向 LLM 公开数据和功能的标准化方式
• 人工参与的安全（所有操作都需要用户批准）
• 不断增长的预构建集成生态系统
• 适用于多种 AI 模型和应用程序

故障排除

Claude 说它无法连接到我的 MCP 服务器：

• 确保 Claude 的开发者设置中的配置正确
• 更改配置后，尝试重新启动 Claude Desktop
• 检查您的 Lunchmoney API 令牌是否有效

Claude 无法识别 Lunchmoney 命令：

• 在 Claude 中开始新的对话
• 尝试在您的查询中明确提及 Lunchmoney（例如，“Show me my recent Lunchmoney transactions”（显示我最近的 Lunchmoney 交易））

API 说明

• 预算数据必须使用月份边界作为日期（例如，2024-01-01 到 2024-01-31）
• 交易可以使用任何日期范围
• 所有货币价值均以其原始货币返回

许可证

MIT

贡献

欢迎贡献！请随时提交 Pull Request。