午餐钱 MCP 服务器

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

特性

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

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。