LunchMoney MCP服务器
](https://www.npmjs.com/package/@akutishevsky/lunchmoney-mcp) ](https://www.npmjs.com/package/@akutishevsky/lunchmoney-mcp) ](https://github.com/akutishevsky/lunchmoney-mcp/releases)   ](https://lobehub.com/mcp/akutishevsky-lunchmoney-mcp)
一种模型上下文协议（MCP）服务器实现 午餐钱，通过LunchMoney的API提供对个人财务管理的程序访问。也可作为MCP捆绑包（.mcpb）在Claude Desktop中轻松安装。
请注意，v2.0.0是一个突破性的版本。 此服务器现在以LunchMoney的v2 API为目标(https://api.lunchmoney.dev/v2，目前处于alpha）。它与此服务器的v1.x不向后兼容：工具名称、字段和端点形状已更改（例如，assets现在是manual_accounts,tags阵列现在tag_ids，交易asset_id现在是manual_account_id，thedebit_as_negative切换已取消，预算摘要已移动到新的/summary端点）。看 更改日志.md 查看完整列表。如果你依赖v1.x，pin@akutishevsky/lunchmoney-mcp@^1.4.3.
目录
- 安装选项 - MCP捆绑包 - 克劳德代码CLI - Codex CLI - 手动MCP配置 - 独立服务器
概述
此MCP服务器使AI助手和其他MCP客户端能够与LunchMoney数据交互，从而实现自动化的财务见解、交易管理、预算等。
特性
全面的工具覆盖
- 用户管理 -访问用户帐户详细信息
- 分类 -对类别和类别组进行完整的CRUD操作
- 标签 -交易标签的完整CRUD
- 交易 -具有高级过滤、批量更新、批量删除、拆分、分组和文件附件的完整CRUD
- 经常性项目 -跟踪和管理经常性费用，包括系统建议的项目
- 预算 -每期预算汇总、全账户预算设置、追加销售和删除
- 手动账户 -手动管理账户（以前称为“资产”）的完整CRUD
- Plaid账户 -列出、检索和触发已连接银行账户的同步
- 加密货币 -通过LunchMoney的v1加密端点跟踪同步和手动加密货币持有情况
关键能力
- 与LunchMoney API v2（alpha）完全集成
- 使用TypeScript和Zod验证的类型安全实现
- 使用令牌高效响应 卡通 编码而不是JSON，减少AI对话中的令牌使用
- 模块化架构，易于扩展
- 使用stdio传输的标准MCP服务器实现
用法
安装选项
MCP捆绑包（.mcpb）-推荐
安装此服务器的最简单方法是在Claude Desktop中作为MCP Bundle安装：
- 下载最新
.mcpb文件来自 发布页面 - 打开克劳德桌面并转到扩展
- 点击“安装扩展”并选择下载的
.mcpb文件 - 提示时输入LunchMoney API代币（从获取 LunchMoney开发者设置)
- LunchMoney工具将立即可用
Claude Code CLI
将LunchMoney MCP服务器添加到Claude代码中：
claude mcp add --transport stdio --env LUNCHMONEY_API_TOKEN=your-api-token-here lunchmoney -- npx -y @akutishevsky/lunchmoney-mcp要启用调试日志记录，请执行以下操作：
claude mcp add --transport stdio --env LUNCHMONEY_API_TOKEN=your-api-token-here --env LUNCHMONEY_DEBUG=true lunchmoney -- npx -y @akutishevsky/lunchmoney-mcp验证服务器是否已添加：
claude mcp list
claude mcp get lunchmoneyCodex CLI
将LunchMoney MCP服务器添加到Codex：
codex mcp add lunchmoney --env LUNCHMONEY_API_TOKEN=your-api-token-here -- npx -y @akutishevsky/lunchmoney-mcp要启用调试日志记录，请执行以下操作：
codex mcp add lunchmoney --env LUNCHMONEY_API_TOKEN=your-api-token-here --env LUNCHMONEY_DEBUG=true -- npx -y @akutishevsky/lunchmoney-mcp验证服务器是否已添加：
codex mcp list
codex mcp get lunchmoneyManual MCP Configuration
要将此MCP服务器与任何兼容MCP的客户端（如Claude Desktop）一起使用，您需要将其添加到客户端的配置中。
配置
可以在MCP客户端的配置文件中配置服务器。确切的位置和格式可能因客户而异，但通常遵循以下模式：
{
"mcpServers": {
"lunchmoney": {
"command": "npx",
"args": ["@akutishevsky/lunchmoney-mcp"],
"env": {
"LUNCHMONEY_API_TOKEN": "your-api-token-here",
"LUNCHMONEY_DEBUG": "true"
}
}
}
}注：LUNCHMONEY_DEBUG是可选的。设置为"true"以启用API请求和对stderr的响应的调试日志记录。有助于故障排除。
替换 "your-api-token-here" 使用您的实际LunchMoney API代币 LunchMoney开发者设置.
通用MCP客户端配置位置
不同的MCP客户端将其配置存储在不同的位置：
- 克劳德桌面版:
- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json - Linux： ~/.config/Claude/claude_desktop_config.json
- 其他MCP客户端：检查客户的文档以获取配置文件位置。
设置步骤
- 找到MCP客户端的配置文件（如果不存在，请创建它）。
- 将LunchMoney服务器配置添加到
mcpServers部分。 - 保存文件并重新启动MCP客户端。
- LunchMoney工具现在应该可以在您的客户中使用。
需求
- 系统上已安装Node.js 16+
npx在您的系统PATH中可用- 具有适当权限的有效LunchMoney API代币
独立服务器
# Run with npx
LUNCHMONEY_API_TOKEN="your-api-token" npx @akutishevsky/lunchmoney-mcp示例提示
以下是您可以在LunchMoney MCP服务器上使用的一些示例提示：
帐户概览
- “显示我的LunchMoney帐户详细信息”
- “我目前的账户状态如何？”
品类管理
- “列出我的所有支出类别”
- “创建一个名为“订阅”的新类别，每月预算为100美元”
- “显示我的‘餐饮’类别的详细信息”
- “为我的所有娱乐费用创建一个类别组”
- 删除“未使用类别”，并将其交易重新分配为“杂项”
事务管理
- “显示上个月的所有交易记录”
- “查找过去一周内所有超过100美元的交易”
- “在亚马逊购物类别中创建45.99美元的新支出”
- “更新交易#12345，将金额更改为50美元”
- “显示所有待处理交易”
- “将这些咖啡店交易组合在一起”
预算编制
- “显示我本月的预算摘要”
- “本月杂货预算为500美元”
- “删除娱乐类别的预算”
- “我在每个类别中的支出与预算相比是多少？”
手动帐户跟踪
- “列出我的所有手动帐户”
- “为我的储蓄账户创建一个新的手动账户，余额为10000美元”
- “将我的投资账户余额更新为25000美元”
- “关闭我的旧信用卡帐户”
经常性支出
- “显示我的所有经常性开支”
- “我有什么订阅？”
- “列出未来3个月的重复项目”
银行一体化
- “显示我所有已连接的Plaid帐户”
- “刷新我的银行账户数据”
- “为我的支票账户触发同步”
加密货币
- “显示我持有的所有加密货币”
- “将我的比特币余额更新为0.5 BTC”
- “列出我手动跟踪的所有加密资产”
分析和见解
- “我这个月的主要支出类别是什么？”
- “显示标记为“假期”的所有交易”
- “查找咖啡店的所有交易”
- “列出所有需要分类的交易”
可用工具
用户工具
get_user-检索当前用户详细信息
分类工具
get_all_categories-列出所有类别（支持format和is_group过滤器）get_single_category-获取特定类别或类别组的详细信息create_category-创建类别或类别组（集is_group=true加children)update_category-更新属性；替换类别组上的子列表delete_category-删除类别；通过force=true覆盖依赖性检查
标记工具
get_all_tags-列出所有标签get_single_tag-按ID获取标签create_tag-创建新标签update_tag-更新标记属性delete_tag-删除标签（带force覆盖家属）
交易工具
get_transactions-列出具有广泛过滤选项（日期范围、帐户、类别、标签、状态、待处理、元数据、文件等）的交易get_single_transaction-获取完整的交易详细信息（始终包括plaid_metata、custom_metata和文件，以及拆分/组父级的子项）create_transactions-在一次通话中插入1-500笔交易update_transaction-一笔交易的部分更新delete_transaction-删除一笔交易（不能拆分/分组）update_transactions_bulk-批量更新1–500笔交易delete_transactions_bulk-按ID批量删除1-500笔交易create_transaction_group-从现有交易创建交易组delete_transaction_group-取消交易组分组split_transaction-将一笔交易拆分为2-500个孩子unsplit_transaction-撤消之前的拆分attach_file_to_transaction-上传本地文件（jpeg/png/heic/heif/pdf，≤10MB）get_transaction_attachment_url-获取文件附件的签名下载URLdelete_transaction_attachment-删除文件附件
重复项目工具
get_recurring_items-列出日期范围内的重复项目(include_suggested系统建议）get_single_recurring_item-按ID获取重复项目
预算工具
get_budget_summary-每类预算摘要（由/summary)；支持事件、总计、滚动池切换get_budget_settings-全账户预算期和显示设置upsert_budget-创建或更新类别和期间的预算remove_budget-删除类别和期间的预算
手动帐户工具
get_all_manual_accounts-列出所有手动管理的帐户（以前称为“资产”）get_single_manual_account-通过ID获取手动帐户create_manual_account-创建新的手动管理帐户update_manual_account-更新手动帐户的属性delete_manual_account-删除手动帐户；还可以选择删除其交易/余额历史记录
Plaid帐户工具
get_all_plaid_accounts-列出所有已连接的Plaid帐户get_single_plaid_account-通过ID获取Plaid帐户trigger_plaid_fetch-从Plaid获取最新数据的触发器（可选范围为日期范围或帐户）
加密工具
get_all_crypto-列出已同步和手动持有的加密货币/v1/cryptoupdate_manual_crypto-通过以下方式更新手动管理的加密货币资产/v1/crypto/manual/:id
发展
项目结构
lunchmoney-mcp/
├── src/
│ ├── index.ts # Server entry point
│ ├── config.ts # Configuration management
│ ├── types.ts # TypeScript type definitions
│ └── tools/ # Tool implementations
│ ├── user.ts
│ ├── categories.ts
│ ├── tags.ts
│ ├── transactions.ts
│ ├── recurring-items.ts
│ ├── budgets.ts
│ ├── manual-accounts.ts
│ ├── plaid-accounts.ts
│ └── crypto.ts
├── build/ # Compiled JavaScript output
├── package.json
├── tsconfig.json
└── README.md建筑
# Build the MCP server
npm run build
# Build MCPB package for distribution
npm run build:mcpb添加新工具
- 在中创建新文件
src/tools/ - 使用MCP SDK实现工具处理程序
- 在中注册工具
src/index.ts - 将类型添加到
src/types.ts如有需要
api参考
服务器实现完整的LunchMoney API v2。有关API的详细文档，请参阅：
贡献
欢迎投稿！请随时提交拉取请求。
许可证
MIT许可证