内容
-mcp-v2
Lunch Money API v2 的 MCP 服务器。首个基于 v2 API 构建的 MCP 服务器。
##
- **14 种工具**，涵盖读取、CRUD 和高级操作
- **丰富响应**: 返回分类、标签和账户名称，而非原始 ID
- **智能缓存**: 启动时缓存分类、标签和账户，自动在变更后刷新
- ****: 通过 `openapi-typescript` 从官方 OpenAPI 规范生成
### 克劳德桌面
将以下内容添加到 `~/ Support/Claude/claude_desktop_config.json` 中：
```json
{
"mcp {
"lunchmoney": {
"command": "n "args": ["l-mcp-v2"],
"env": {
"LUNCHMONEY_TOKEN": "your-api-token-here"
}
}
}
}
```
### 克劳德代码
将以下内容添加到项目中的 `.mcp.json` 或全局的 `~/.claude/mcp.json` 中：
```json
{
"mcpServers": {
"lunchmoney": {
"command": "npx",
"args": ["lunchcp-v2"],
"env "LUNCHMONEY "your-api-token"
}
}
```
从 [Lunch Money设置](https://my.l.app/developers) 获取您的 API 。
## 工具 读取
| 工具 |
|---|---|
| `` | 账户信息（电子邮件、货币） |
| `list_transactions` | 列出/搜索交易记录，应用筛选条件，或 查询 |
| `list | 所有分类（嵌套或视图） |
| `list | 所有标签 |
| `` | 手动账户和，附带余额 |
| `get_summary` | 预算收入/支出/分类明细 |
get_recurring` |项目（订阅、账单） |
### CRUD
| | 操作 | 描述 |
|---|---|---|
manage_transaction` | 创建、删除 | 单个交易记录操作 |
| `manage_category`、更新、删除 | 分类强制删除附带依赖 |
| `manage_tag` | 创建、删除 | 标签管理删除附带依赖信息 `manage_account` |更新、删除 | 手动（Plaid 账户只读） |
### 高级
| | 操作 | 描述 |
|| `bulk_update_transactions` | — | 批量更新最多 500 条交易记录 |
| `split_transaction 分割、合并 | 将交易记录分割成多个部分或恢复原状 |
| `group_transactions` | 分组、取消分组 | 将交易记录组合成一组或恢复原状 |
## 示例提示
连接后，自然地询问您的 LLM：
**查看和整理**
- "显示本月所有未审核的交易记录 "将我的所有亚马逊交易记录归类为购物 "我上周在杂花了多少钱？"
- " 5 条交易记录标记为已**预算概览**
- 1 月份总结"
- "我的定期开支是多少？"
- "我每个账户里有多少余额？"
**记录**
- "添加一条昨晚 餐厅 45 美元的交易记录"
- "将 120 美元的 Costco 交易记录分割成 80 美元的杂货和 40 美元的家庭开支 "将这三条优步交易记录合并成一条"
-我刚刚创建的重复交易**整理**
- "创建一个名为 Side Projects 的新分类"
用 travel 标签标记这些交易记录"
- "显示所有分类及其 ID"
- "将 Dining Out 分类重命名为 Restaurants"
## 开发
```bash
npm install
npm run build
npm start
```
从 OpenAPI 规范重新生成类型：
```bash
npm run generate:types
```
## 架构
```
src/
index.ts 入口点 — 注册工具，初始化缓存
.ts openapi-fetch + 错误处理
分类、标签、账户缓存
format.ts 所有响应类型的文本格式化程序
types.ts 从 @lunch-money/v2-api-spec 生成
/
user.ts get transactions.ts list_transactions, manage_transaction, bulk_update, split, categories.ts list_categories
tags.ts list_tags, manage_tag
get_accounts, manage summary.ts get_summary recurring.ts get_recurring
```
## 许可证
MIT
