Lunchmoney MCP 服务器

一个模型上下文协议 (MCP) 服务器，让你通过 Claude 和其他 AI 助手与你的 Lunchmoney 交易和预算进行交互。

功能

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

1. get-recent-transactions: 查看过去 N 天的近期交易
2. search-transactions: 通过收款人名称或备注中的关键字搜索交易
3. get-category-spending: 分析特定类别的支出
4. get-budget-summary: 获取详细的预算信息，包括支出、剩余金额和经常性项目

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Lunchmoney MCP 服务器：

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

你可以直接在 Claude Desktop 中使用此服务器，无需安装：

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

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

使用示例

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

交易

• "Show me my recent transactions from the past week" (显示我过去一周的近期交易)
• "Search for all transactions at Amazon" (搜索所有在亚马逊的交易)
• "How much did I spend on restaurants last month?" (我上个月在餐厅花了多少钱？)
• "Find transactions tagged as business expenses" (查找标记为业务费用的交易)

预算

• "Show me my budget summary for this month" (显示我本月的预算摘要)
• "What's my budget status from January to March 2024?" (我从 2024 年 1 月到 3 月的预算状况如何？)
• "How much of my food budget is remaining?" (我的食物预算还剩多少？)
• "Show me categories where I'm over budget" (显示我超出预算的类别)

什么是 MCP？

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

MCP 的一些主要优点：

• 标准化的方式向 LLM 公开数据和功能
• 人工参与的安全 (所有操作都需要用户批准)
• 不断增长的预构建集成生态系统
• 适用于多种 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。