Lunchmoney MCP Server

基本能力

产品定位

Lunchmoney MCP Server 是一个金融服务工具，旨在通过 AI 助手帮助用户管理个人财务，包括交易记录和预算分析。

核心功能

1. get-recent-transactions: 查看过去 N 天的近期交易记录。
2. search-transactions: 通过关键词搜索交易记录（支付方名称或备注）。
3. get-category-spending: 分析特定类别的支出情况。
4. get-budget-summary: 获取详细的预算信息，包括支出、剩余金额和定期项目。

适用场景

• 个人财务管理
• 预算跟踪和分析
• 交易记录查询和搜索

工具列表

1. get-recent-transactions: 查看近期交易记录。
2. search-transactions: 搜索交易记录。
3. get-category-spending: 分析类别支出。
4. get-budget-summary: 获取预算摘要。

常见问题解答

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

使用教程

使用依赖

需要安装 Node.js 和 npm。

安装教程

1. 通过 Smithery 安装：

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

1. 直接使用（无需安装）：

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

调试方式

1. 克隆仓库：

git clone <repository-url>

1. 安装依赖：

npm install

1. 构建 TypeScript 代码：

npm run build

1. 运行服务：

LUNCHMONEY_TOKEN=your_token_here node build/index.js

1. 使用 MCP Inspector 测试：

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

许可证

该项目遵循 MIT 开源许可条款。