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 是一个软件平台，允许你在计算机上（浏览器之外）运行 JavaScript 代码。

要安装 Node.js：

• Windows/Mac: 从 官方 Node.js 网站 下载并运行安装程序
• Mac with Homebrew: 在终端中运行 brew install node
• Linux: 使用你的包管理器（例如，对于 Ubuntu，使用 sudo apt install nodejs）

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

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 Desktop 以使更改生效。

示例用法

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

交易

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

预算

• "显示我本月的预算概要"
• "2024年1月至3月我的预算状态如何？"
• "我的食品预算还剩多少？"
• "显示我超出预算的类别"

什么是 MCP？

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

MCP 的一些主要优势包括：

• 标准化地向 LLMs 暴露数据和功能
• 人工参与的安全机制（所有操作都需要用户批准）
• 不断增长的预构建集成生态系统
• 支持多种 AI 模型和应用

故障排除

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

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

Claude 不识别 Lunchmoney 命令：

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

API 注意事项

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

许可证

MIT

贡献

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