🚀 午餐钱 MCP 服务器
午餐钱 MCP 服务器是一个模型上下文协议（MCP）服务器，它能让您借助 Claude 和其他 AI 助手，与 Lunchmoney 的交易和预算进行交互，为您的财务管理提供便利。
🚀 快速开始
在配置好服务器后，您可以在 Claude 桌面与服务器交互，提出关于交易和预算的相关问题，如“显示我过去一周的近期交易”“显示本月的预算概览”等。
✨ 主要特性
此服务器提供了四个主要工具：
- 查看最近交易：查看过去 N 天内的近期交易
- 搜索交易：按付款人名称或备注中的关键字搜索交易
- 分析分类支出：查看特定类别的支出情况
- 获取预算概览：获得详细的预算信息，包括支出、剩余金额和重复项目
📦 安装指南
通过 Smithery 安装
要通过 Smithery 自动安装 Lunchmoney MCP 服务器到 Claude 桌面，可使用以下命令：
npx -y @smithery/cli install @leafeye/lunchmoney-mcp-server --client claude
您也可以直接在 Claude 桌面上使用此服务器，无需安装，按以下配置：
{
"mcpServers": {
"lunchmoney": {
"command": "npx",
"args": ["-y", "lunchmoney-mcp-server"],
"env": {
"LUNCHMONEY_TOKEN": "your_token_here"
}
}
}
}
请将 your_token_here 替换为您的 Lunchmoney API 令牌，您可以在 您的 Lunchmoney 开发者设置 中获取。
💻 使用示例
在 Claude 桌面配置完成后，您可以提出以下问题：
基础用法
交易
- "显示我过去一周的近期交易"
- "搜索所有亚马逊交易"
- "上个月我在餐厅花了多少钱？"
- "查找标记为商务支出的交易"
预算
- "显示本月的预算概览"
- "2024 年 1 月至 3 月的预算状态是什么？"
- "我的食品预算是多少剩余金额？"
- "显示超出预算的类别"
📚 详细文档
什么是 MCP？
模型上下文协议（MCP） 是一项开放协议，标准定义了应用程序如何向大型语言模型（LLMs）提供上下文。可以将其视为 AI 应用程序的 USB - C 端口——它为连接不同数据源和工具到 AI 模型提供了一种标准化方式。
MCP 的一些关键优势：
- 标准化地将数据和功能暴露给大语言模型的方式
- 人机协作的安全性（所有操作都需要用户批准）
- 不断增长的现成集成生态系统
- 支持多种 AI 模型和应用程序
开发
要本地开发：
- 克隆此仓库
- 安装依赖：
npm install
- 构建 TypeScript 代码：
npm run build
- 使用 API 令牌运行：
LUNCHMONEY_TOKEN=your_token_here node build/index.js
- 使用 MCP Inspector 测试：
LUNCHMONEY_TOKEN=your_token_here npx @modelcontextprotocol/inspector node build/index.js
API 注意事项
- 预算数据必须使用月份边界日期（例如，2024 - 01 - 01 到 2024 - 01 - 31）
- 交易可以使用任何日期范围
- 所有货币值都以原始货币返回
- 类别名称在搜索时大小写不敏感
📄 许可证
本项目采用 MIT 许可证。
🤝 贡献
欢迎贡献！请随意提交 Pull Request。