午餐钱 MCP 服务器

一个让你通过Claude和其他AI助手与Lunchmoney（https://lunchmoney.app）交易和预算交互的模型上下文协议（MCP）服务器。

这是什么？

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

功能

此服务器提供四个主要功能：

1. 获取最近交易：查看过去N天的最近交易
2. 搜索交易：按付款人名称或备注中的关键字搜索交易
3. 分类别支出：分析特定类别的支出情况
4. 预算概览：获得详细的预算信息，包括支出、剩余金额和重复项目

隐私与数据处理

重要提示：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 with Homebrew：在终端中运行brew install node
• Linux：使用你的包管理器（例如Ubuntu的sudo apt install nodejs）

安装完成后，你可以直接通过运行服务器而不必下载任何内容：

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才能应用更改。

使用示例

• 获取最近交易：发送请求到MCP服务器以获取过去7天的交易记录
• 搜索交易：通过指定关键字或类别来筛选特定交易
• 分类别支出：分析不同类别的总支出金额
• 预算概览：检查每个预算项目的当前剩余金额和使用情况

MCP 介绍

模型上下文协议（MCP）是一种用于连接不同AI服务和数据源的标准化接口。通过MCP，可以实现更高效的数据交互和任务处理。

故障排除

如果遇到问题，请按照以下步骤操作：

1. 确保Node.js已正确安装
2. 检查Lunchmoney API令牌是否有效
3. 确认网络连接正常
4. 查看MCP服务器的日志以获取更多信息

API 说明

• 日期范围：预算使用YYYY-MM-DD格式（例如：2024-01-01到2024-01-31）
• 交易范围：可以使用任何日期范围
• 货币值：所有金额均以原始货币返回

许可证

MIT

贡献指南

欢迎贡献！请随时提交拉取请求。