Lunchmoney MCP 服务器
模型上下文协议 (MCP) 服务器可让您通过 Claude 和其他 AI 助手与您的Lunchmoney交易和预算进行交互。
这是什么?
该工具允许您将 Lunchmoney 财务数据连接到 Claude AI,以便您可以询问有关支出的问题、分析预算并通过自然对话了解您的财务状况。
Related MCP server: Linear
特征
该服务器提供四个主要工具:
get-recent-transactions :查看过去 N 天的最近交易
搜索交易:按收款人姓名或备注中的关键字搜索交易
get-category-spending :分析特定类别的支出
get-budget-summary :获取详细的预算信息,包括支出、剩余金额和经常性项目
隐私和数据处理
重要提示: MCP 为 Claude 提供了一种结构化的方式,使其能够与您的 Lunchmoney 数据进行交互,同时保持隐私边界。以下是您需要了解的信息:
Claude(主持人)创建一个连接到本地 MCP 服务器的客户端
您的 Lunchmoney API 令牌保留在您的本地机器上
MCP 服务器在本地运行并从 Lunchmoney 的 API 获取数据
您将被要求批准访问 Lunchmoney 数据的每个请求
当你询问财务状况问题时,Claude 会向 MCP 服务器请求具体信息
MCP 服务器在本地处理您的请求并仅返回相关结果
Claude 永远无法直接访问您的完整财务数据或 API 令牌
仅与 Claude 共享所请求的特定信息(例如交易摘要或预算状态)
Anthropic 的数据保留政策适用于这些作为您对话一部分的摘要结果
每个服务器连接都是独立的,保持清晰的安全边界
您可以在文档中找到有关 MCP 的更多信息: https://modelcontextprotocol.io/introduction
安装
另请参阅 Claude 官方文档: https://modelcontextprotocol.io/quickstart/user
使用 npx
Node.js 是一个软件平台,可让您在计算机上(在 Web 浏览器之外)运行 JavaScript 代码。
要安装 Node.js:
Windows/Mac :从Node.js 官方网站下载并运行安装程序
Mac 上的 Homebrew :在终端中运行
brew install nodeLinux :使用你的包管理器(例如,Ubuntu 的
sudo apt install nodejs)
一旦 Node.js 安装在您的计算机上,您就可以直接运行服务器而无需下载任何东西:
从Lunchmoney 开发者设置中获取 Lunchmoney API 令牌
打开 Claude 桌面
前往“设置”→“开发者”→
Edit Config添加以下配置:
将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(例如,“显示我最近的 Lunchmoney 交易”)
API 说明
预算数据必须使用月份作为日期界限(例如,2024 年 1 月 1 日至 2024 年 1 月 31 日)
交易可以使用任何日期范围
所有货币价值均以其原始货币返回
执照
麻省理工学院
贡献
欢迎贡献代码!欢迎提交 Pull 请求。