🚀 午餐钱 MCP 服务器
午餐钱 MCP 服务器是一个基于模型上下文协议（MCP）的工具，它借助 Claude 等 AI 助手，实现与 Lunchmoney（https://lunchmoney.app）进行交易和预算交互，让你能以自然对话的方式轻松管理财务数据。
🚀 快速开始
此工具可将你的 Lunchmoney 财务数据与 Claude AI 相连接，你能通过自然对话询问支出情况、分析预算并获取财务见解。
✨ 主要特性
此服务器具备四个主要功能：
- 获取最近交易：可查看过去 N 天的最近交易记录。
- 搜索交易：能按付款人名称或备注中的关键字搜索交易。
- 分类别支出：可分析特定类别的支出状况。
- 预算概览：能获取详细的预算信息，涵盖支出、剩余金额和重复项目。
⚠️ 重要提示
⚠️ 重要提示
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）。
安装完成后，你可以直接通过运行服务器而不必下载任何内容：
- 从你的Lunchmoney 开发者设置获取 Lunchmoney API 令牌。
- 打开 Claude Desktop。
- 转到设置 → 开发者 →
编辑配置。 - 添加以下配置：
{
"mcpServers": {
"lunchmoney": {
"command": "npx",
"args": ["-y", "lunchmoney-mcp-server"],
"env": {
"LUNCHMONEY_TOKEN": "your_token_here"
}
}
}
}
将your_token_here替换为你的实际 Lunchmoney API 令牌。
⚠️ 重要提示
更改配置后，可能需要重新启动 Claude 才能应用更改。
💻 使用示例
基础用法
- 获取最近交易：发送请求到 MCP 服务器以获取过去 7 天的交易记录。
- 搜索交易：通过指定关键字或类别来筛选特定交易。
- 分类别支出：分析不同类别的总支出金额。
- 预算概览：检查每个预算项目的当前剩余金额和使用情况。
📚 详细文档
你可以在文档中找到更多关于 MCP 的信息：https://modelcontextprotocol.io/introduction
📄 许可证
本项目采用 MIT 许可证。
贡献指南
欢迎贡献！请随时提交拉取请求。