lunchmoney-mcp

Lunchmoney MCP 服务器

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

这是什么？

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

特征

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

1. get-recent-transactions ：查看过去 N 天的最近交易
2. 搜索交易：按收款人姓名或备注中的关键字搜索交易
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 官方网站下载并运行安装程序
• Mac 上的 Homebrew ：在终端中运行brew install node
• Linux ：使用你的包管理器（例如，Ubuntu 的sudo apt install nodejs ）

一旦 Node.js 安装在您的计算机上，您就可以直接运行服务器而无需下载任何东西：

1. 从Lunchmoney 开发者设置中获取 Lunchmoney API 令牌
2. 打开 Claude 桌面
3. 前往“设置”→“开发者”→ Edit Config
4. 添加以下配置：

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

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

示例用法

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

交易

• “显示我过去一周的近期交易”
• “搜索亚马逊的所有交易”
• “我上个月在餐馆花了多少钱？”
• “查找标记为业务费用的交易”

预算

• “显示我本月的预算摘要”
• “2024 年 1 月至 3 月我的预算状况如何？”
• “我的伙食预算还剩多少？”
• “显示超出预算的类别”

什么是 MCP？

模型上下文协议 (MCP)是一种开放协议，它规范了应用程序向大型语言模型 (LLM) 提供上下文的方式。MCP 就像 AI 应用程序的 USB-C 端口一样，它提供了一种标准化的方式，将 AI 模型连接到不同的数据源和工具。

MCP 的一些主要优点：

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

故障排除

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

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

克劳德无法识别 Lunchmoney 命令：

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

API 说明

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

执照

麻省理工学院

贡献

欢迎贡献代码！欢迎提交 Pull 请求。