Lunchmoney MCP Server

这是一个模型上下文协议（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使用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中配置好后，您可以提出如下问题：

交易

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

预算

• "显示我本月的预算摘要"
• "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说明

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

许可证

MIT

贡献

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