Lunchmoney MCP Server

Lunchmoney MCP Server

一个 Model Context Protocol（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 token 保留在本地计算机上
• MCP 服务在本地运行，并从 Lunchmoney API 获取数据
• 每次访问 Lunchmoney 数据时，系统都会询问你是否批准
• 当你询问财务相关问题时，Claude 会向 MCP 服务请求特定信息
• MCP 服务在本地处理请求，并仅返回相关结果
• Claude 无法直接访问你的全部财务数据或 API token
• 只有你请求的特定信息（例如交易摘要或预算状态）会与 Claude 共享
• Anthropic 的数据保留政策适用于作为对话内容的这些摘要结果
• 每个服务连接彼此隔离，确保安全边界清晰

你可以在文档中了解更多 MCP 信息：https://modelcontextprotocol.io/introduction

安装

另请参阅 Claude 官方文档：https://modelcontextprotocol.io/quickstart/user

使用 npx

Node.js 是一个软件平台，可让你在计算机上运行 JavaScript 代码（在 Web 浏览器之外）。

安装 Node.js：

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

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

1. 从 Lunchmoney 开发者设置获取 Lunchmoney API token
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 token。

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

使用示例

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

交易

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

预算

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

什么是 MCP？

模型上下文协议（MCP）是一种开放协议，用于标准化应用向大语言模型（LLM）提供上下文的方式。可以把 MCP 想象成 AI 应用的 USB-C 接口——它提供了一种标准化方式，可将 AI 模型连接到不同的数据源和工具。

MCP 的一些主要优势：

• 为向大模型提供数据和功能提供标准化方式
• 人机协同安全机制（所有操作都需要用户批准）
• 不断发展的预构建集成生态系统
• 兼容多种 AI 模型和应用

故障排查

Claude 提示无法连接到我的 MCP 服务：

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

Claude 无法识别 Lunchmoney 命令：

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

API 说明

• 预算数据的日期必须使用月初和月末（例如，2024-01-01 至 2024-01-31）
• 交易可以使用任意日期范围
• 所有金额均以其原始货币返回

许可证

MIT

贡献

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