LunchMoney MCP Server

LunchMoney 的模型上下文协议 (MCP) 服务器实现，通过 LunchMoney 的 API 提供对个人财务管理的程序化访问。也可作为桌面扩展工具 (DXT)，便于在 Claude Desktop 中安装。

<a href="https://glama.ai/mcp/servers/@akutishevsky/lunchmoney-mcp"> <img width="380" height="200" src="https://gips2.baidu.com/it/u=1971159020,3754810925&fm=3081&app=3081&f=PNG?w=760&h=400" alt="LunchMoney Server MCP 服务器" /> </a>

概述

此 MCP 服务器允许 AI 助手和其他 MCP 客户端与 LunchMoney 数据进行交互，支持自动化的财务洞察、交易管理、预算制定等功能。

特性

全面的工具覆盖

• 用户管理 - 访问用户账户详情
• 类别 - 创建、更新和组织支出类别
• 标签 - 管理交易标签
• 交易 - 对交易执行完整的 CRUD 操作，并带有高级过滤
• 重复项目 - 跟踪和管理重复性支出
• 预算 - 按类别创建和监控预算
• 资产 - 跟踪手动管理的资产
• Plaid 账户 - 管理连接的银行账户
• 加密货币 - 跟踪加密货币持有量

关键能力

• 完整集成 LunchMoney API v1
• 使用 TypeScript 和 Zod 验证的类型安全实现
• 模块化架构，易于扩展
• 使用标准 MCP 服务器实现，采用 stdio 传输

使用方法

安装选项

选项 1：桌面扩展工具 (DXT) - 推荐

最简单的安装方式是将其作为 Claude Desktop 的桌面扩展工具：

1. 从发布页面下载最新的 .dxt 文件。
2. 打开 Claude Desktop 并进入扩展部分。
3. 点击“安装扩展”并选择下载的 .dxt 文件。
4. 当提示时输入您的 LunchMoney API 令牌（从LunchMoney 开发者设置获取）。
5. LunchMoney 工具将立即可用。

选项 2：手动 MCP 配置

要使用任何兼容 MCP 的客户端（如 Claude Desktop），您需要将其添加到客户端的配置中。

配置

可以在您的 MCP 客户端配置文件中配置该服务器。具体位置和格式可能因客户端而异，但通常遵循以下模式：

{
    "mcpServers": {
        "lunchmoney": {
            "command": "npx",
            "args": ["@akutishevsky/lunchmoney-mcp"],
            "env": {
                "LUNCHMONEY_API_TOKEN": "your-api-token-here"
            }
        }
    }
}

将 "your-api-token-here" 替换为您实际的 LunchMoney API 令牌，从LunchMoney 开发者设置获取。

常见 MCP 客户端配置位置

不同的 MCP 客户端存储其配置的位置不同：

• Claude Desktop：

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

• 其他 MCP 客户端：查阅您的客户端文档以了解配置文件位置。

设置步骤

1. 查找您的 MCP 客户端配置文件（如果不存在，请创建）。
2. 将 LunchMoney 服务器配置添加到 mcpServers 部分。
3. 保存文件并重启您的 MCP 客户端。
4. LunchMoney 工具现在应在您的客户端中可用。

要求

• 系统上安装了 Node.js 16+
• 系统 PATH 中有 npx
• 具有适当权限的有效 LunchMoney API 令牌

作为独立的 MCP 服务器

# 使用 npx 运行
LUNCHMONEY_API_TOKEN="your-api-token" npx @akutishevsky/lunchmoney-mcp

示例提示

这里有一些您可以与 LunchMoney MCP 服务器一起使用的示例提示：

账户概览

• "显示我的 LunchMoney 账户详情"
• "当前账户状态是什么？"

类别管理

• "列出我所有的支出类别"
• "创建一个名为 '订阅' 的新类别，月预算为 $100"
• "显示 '食品及餐饮' 类别的详细信息"
• "为我所有的娱乐费用创建一个类别组"
• "删除 '未使用类别' 并将其交易重新分配给 '杂项'"

交易管理

• "显示上个月的所有交易"
• "查找过去一周内超过 $100 的所有交易"
• "在购物类别下创建一个新的 $45.99 的亚马逊消费"
• "更新交易 #12345，将金额更改为 $50"
• "显示所有待处理的交易"
• "将这些咖啡店交易组合在一起"

预算

• "显示本月的预算总结"
• "为本月的杂货设定 $500 的预算"
• "移除娱乐类别的预算"
• "每个类别中我已经花费了多少，相对于预算？"

资产跟踪

• "列出我所有的资产"
• "为我的储蓄账户创建一个余额为 $10,000 的新资产"
• "更新我的投资账户余额至 $25,000"

重复性支出

• "显示我所有的重复性支出"
• "我有哪些订阅？"
• "列出未来三个月内的重复项目"

银行整合

• "显示我所有的连接 Plaid 账户"
• "刷新我的银行账户数据"
• "触发我的支票账户同步"

加密货币

• "显示我所有的加密货币持有量"
• "更新我的比特币余额至 0.5 BTC"
• "列出我手动追踪的所有加密货币资产"

分析与洞察

• "这个月我的主要支出类别是什么？"
• "显示所有标记为 '假期' 的交易"
• "查找所有在咖啡店发生的交易"
• "列出所有需要分类的交易"

可用工具

用户工具

• get_user - 获取当前用户详情

类别工具

• get_all_categories - 列出所有支出类别
• get_single_category - 获取特定类别的详细信息
• create_category - 创建新的类别
• create_category_group - 创建类别组
• update_category - 更新类别属性
• add_to_category_group - 将类别添加到组中
• delete_category - 删除类别
• force_delete_category - 强制删除并清理数据

标签工具

• get_all_tags - 列出所有可用标签

交易工具

• get_transactions - 列出具有广泛过滤选项的交易
• get_single_transaction - 获取详细的交易信息
• create_transactions - 创建新的交易
• update_transaction - 更新现有交易
• unsplit_transactions - 从拆分组中移除交易
• get_transaction_group - 获取交易组详细信息
• create_transaction_group - 创建交易组
• delete_transaction_group - 删除交易组

重复项目工具

• get_recurring_items - 列出指定日期范围内的重复项目

预算工具

• get_budget_summary - 获取指定日期范围内的预算总结
• upsert_budget - 创建或更新预算金额
• remove_budget - 移除类别的预算

资产工具

• get_all_assets - 列出所有手动管理的资产
• create_asset - 创建新的资产
• update_asset - 更新资产属性

Plaid 账户工具

• get_all_plaid_accounts - 列出所有连接的 Plaid 账户
• trigger_plaid_fetch - 触发从 Plaid 获取最新数据

加密货币工具

• get_all_crypto - 列出所有加密货币资产
• update_manual_crypto - 更新手动管理的加密货币余额

开发

项目结构

lunchmoney-mcp/
├── src/
│   ├── index.ts           # 服务器入口点
│   ├── config.ts          # 配置管理
│   ├── types.ts           # TypeScript 类型定义
│   └── tools/             # 工具实现
│       ├── user.ts
│       ├── categories.ts
│       ├── tags.ts
│       ├── transactions.ts
│       ├── recurring-items.ts
│       ├── budgets.ts
│       ├── assets.ts
│       ├── plaid-accounts.ts
│       └── crypto.ts
├── build/                 # 编译后的 JavaScript 输出
├── package.json
├── tsconfig.json
└── README.md

构建

# 构建 MCP 服务器
npm run build

# 构建用于发布的 DXT 包
npm run build:dxt

添加新工具

1. 在 src/tools/ 中创建一个新文件。
2. 使用 MCP SDK 实现工具处理器。
3. 在 src/index.ts 中注册工具。
4. 如需，向 src/types.ts 添加类型。

API 参考

服务器实现了完整的 LunchMoney API v1。有关详细的 API 文档，请参阅：

• LunchMoney API 文档
• 模型上下文协议规范

贡献

欢迎贡献！请随时提交拉取请求。

许可证

MIT 许可证