Lunchmoney MCP服务器
一个模型上下文协议（MCP）服务器，允许您与您的 午餐钱 通过Claude和其他人工智能助手进行交易和预算。
这是什么？
该工具允许您将Lunchmoney财务数据连接到Claude AI，这样您就可以通过自然对话询问有关支出的问题、分析预算并获得有关财务的见解。
特性
此服务器提供四个主要工具：
- 获取最近的交易记录：查看过去N天的最近交易
- 搜索交易记录：按收款人姓名或票据中的关键字搜索交易
- 获取类别支出：分析特定类别的支出
- 获取预算摘要：获取详细的预算信息，包括支出、剩余金额和经常性项目
隐私和数据处理
重要提示： MCP为Claude提供了一种结构化的方式来与您的Lunchmoney数据进行交互，同时保持隐私边界。以下是你应该知道的：
- Claude（主机）创建一个连接到本地MCP服务器的客户端
- 您的Lunchmoney API代币保留在本地机器上
- MCP服务器在本地运行，并从Lunchmoney的API获取数据
- 您将被要求批准每个访问您的午餐钱数据的请求
- 当您询问有关财务的问题时，Claude会向MCP服务器请求具体信息
- MCP服务器在本地处理您的请求，并仅返回相关结果
- Claude从未直接访问您的完整财务数据或API代币
- 仅与Claude共享所请求的特定信息（如交易摘要或预算状态）
- Anthropic的数据保留政策适用于您对话中的这些摘要结果
- 每个服务器连接都是隔离的，保持了清晰的安全边界
您可以在文档中找到有关MCP的更多信息：https://modelcontextprotocol.io/introduction
安装
另请查看克劳德的官方文档：https://modelcontextprotocol.io/quickstart/user
使用npx
Node.js是一个软件平台，允许您在计算机上运行JavaScript代码（在web浏览器之外）。
要安装Node.js，请执行以下操作：
- Windows/Mac：从下载并运行安装程序
- Mac与Homebrew：运行
brew install node在终端 - Linux：使用您的包管理器（例如。，
sudo apt install nodejs适用于Ubuntu）
一旦Node.js安装在您的计算机上，您就可以直接运行服务器，而无需下载任何内容：
- 从您的 Lunchmoney开发者设置
- 打开克劳德桌面
- 转到“设置”→ 开发者->
Edit Config - 添加以下配置：
{
"mcpServers": {
"lunchmoney": {
"command": "npx",
"args": ["-y", "lunchmoney-mcp-server"],
"env": {
"LUNCHMONEY_TOKEN": "your_token_here"
}
}
}
}替换 your_token_here 使用您的实际Lunchmoney API代币。
重要提示： 更改配置后，您可能需要重新启动Claude Desktop才能使更改生效。
示例用法
在Claude Desktop中配置后，您可以提出以下问题：
交易
- “显示我过去一周的最近交易”
- “在亚马逊搜索所有交易”
- “上个月我在餐馆花了多少钱？”
- “查找标记为业务费用的交易”
预算
- “显示我本月的预算摘要”
- “2024年1月至3月，我的预算状况如何？”
- “我的食物预算还剩多少？”
- “显示超出预算的类别”
什么是MCP？
这 模型上下文协议（MCP） 是一个开放协议，规范了应用程序如何向大型语言模型（LLM）提供上下文。将MCP想象成AI应用程序的USB-C端口——它提供了一种将AI模型连接到不同数据源和工具的标准化方法。
MCP的一些关键优势：
- 向LLM公开数据和功能的标准化方法
- 人在环安全（所有操作都需要用户批准）
- 不断增长的预构建集成生态系统
- 适用于多种AI模型和应用程序
故障排除
Claude说它无法连接到我的MCP服务器：
- 确保Claude的开发人员设置中的配置正确
- 更改配置后尝试重新启动Claude Desktop
- 检查您的Lunchmoney API代币是否有效
克劳德无法识别Lunchmoney命令：
- 在Claude中开始新的对话
- 尝试在查询中明确提及Lunchmoney（例如，“显示我最近的Lunchmonex交易”）
API注释
- 预算数据必须使用月份边界作为日期（例如，2024-01-01至2024-01-31）
- 交易可以使用任何日期范围
- 所有货币价值均以原始货币返回
许可证
麻省理工学院
贡献
欢迎投稿！请随时提交拉取请求。