Lunchmoney MCP Server

Lunchmoney MCP Server

site icon
2025.02.28 6
TypeScript财务分析预算管理金融服务
Lunchmoney MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,允许用户通过 Claude 和其他 AI 助手与其 Lunchmoney 的交易和预算数据进行交互。该服务提供了查询交易、分析预算和获取财务洞察的功能,同时确保数据隐私和安全。
View on GitHub

Overview

基本能力

产品定位

Lunchmoney MCP Server 是一个连接用户 Lunchmoney 财务数据与 AI 助手的桥梁,旨在通过自然语言交互提供财务数据查询和分析功能。

核心功能

  1. 获取近期交易:查看过去 N 天的交易记录。
  2. 搜索交易:通过关键词搜索交易记录。
  3. 获取类别支出:分析特定类别的支出情况。
  4. 获取预算摘要:获取包括支出、剩余金额和定期项目在内的详细预算信息。

适用场景

  • 查询近期交易记录。
  • 分析特定时间段或类别的支出情况。
  • 监控预算使用情况和剩余金额。

工具列表

  1. get-recent-transactions:查看近期交易记录。
  2. search-transactions:通过关键词搜索交易。
  3. get-category-spending:分析特定类别的支出。
  4. get-budget-summary:获取预算详细信息。

常见问题解答

  • Claude 无法连接到 MCP 服务器:检查配置是否正确,重启 Claude Desktop,确认 API 令牌有效。
  • Claude 无法识别 Lunchmoney 命令:开始新对话,明确提及 Lunchmoney。

使用教程

使用依赖

安装 Node.js: - Windows/Mac:从 Node.js 官网 下载并运行安装程序。 - Mac with Homebrew:在终端运行 brew install node。 - Linux:使用包管理器(如 Ubuntu 的 sudo apt install nodejs)。

安装教程

  1. Lunchmoney 开发者设置 获取 API 令牌。
  2. 打开 Claude Desktop,进入 Settings → Developer → Edit Config
  3. 添加以下配置:
{
  "mcpServers": {
    "lunchmoney": {
      "command": "npx",
      "args": ["-y", "lunchmoney-mcp-server"],
      "env": {
        "LUNCHMONEY_TOKEN": "your_token_here"
      }
    }
  }
}
  1. 替换 your_token_here 为实际的 Lunchmoney API 令牌。
  2. 重启 Claude Desktop 使配置生效。

调试方式

  • 确保配置正确。
  • 重启 Claude Desktop。
  • 检查 API 令牌有效性。

许可证

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