🚀 午餐钱 MCP 服务器

午餐钱 MCP 服务器是一个模型上下文协议（MCP）服务器，它能让您借助 Claude 和其他 AI 助手，与 Lunchmoney 的交易和预算进行交互，为您的财务管理提供便利。

🚀 快速开始

在配置好服务器后，您可以在 Claude 桌面与服务器交互，提出关于交易和预算的相关问题，如“显示我过去一周的近期交易”“显示本月的预算概览”等。

✨ 主要特性

此服务器提供了四个主要工具：

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

📦 安装指南

通过 Smithery 安装

要通过 Smithery 自动安装 Lunchmoney MCP 服务器到 Claude 桌面，可使用以下命令：

npx -y @smithery/cli install @leafeye/lunchmoney-mcp-server --client claude

您也可以直接在 Claude 桌面上使用此服务器，无需安装，按以下配置：

{
  "mcpServers": {
    "lunchmoney": {
      "command": "npx",
      "args": ["-y", "lunchmoney-mcp-server"],
      "env": {
        "LUNCHMONEY_TOKEN": "your_token_here"
      }
    }
  }
}

请将 your_token_here 替换为您的 Lunchmoney API 令牌，您可以在 您的 Lunchmoney 开发者设置 中获取。

💻 使用示例

在 Claude 桌面配置完成后，您可以提出以下问题：

基础用法

交易

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

预算

• "显示本月的预算概览"
• "2024 年 1 月至 3 月的预算状态是什么？"
• "我的食品预算是多少剩余金额？"
• "显示超出预算的类别"

📚 详细文档

什么是 MCP？

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

MCP 的一些关键优势：

• 标准化地将数据和功能暴露给大语言模型的方式
• 人机协作的安全性（所有操作都需要用户批准）
• 不断增长的现成集成生态系统
• 支持多种 AI 模型和应用程序

开发

要本地开发：

1. 克隆此仓库
2. 安装依赖：

npm install

3. 构建 TypeScript 代码：

npm run build

4. 使用 API 令牌运行：

LUNCHMONEY_TOKEN=your_token_here node build/index.js

5. 使用 MCP Inspector 测试：

LUNCHMONEY_TOKEN=your_token_here npx @modelcontextprotocol/inspector node build/index.js

API 注意事项

• 预算数据必须使用月份边界日期（例如，2024 - 01 - 01 到 2024 - 01 - 31）
• 交易可以使用任何日期范围
• 所有货币值都以原始货币返回
• 类别名称在搜索时大小写不敏感

📄 许可证

本项目采用 MIT 许可证。

🤝 贡献

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