Lunchmoney MCP 数据交互服务器
一种MCP服务器，它允许人工智能助手与您的Lunchmoney数据进行交互，从而实现关于交易、预算和支出模式的自然语言查询。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"lunchmoney": {
"args": [
"-y",
"lunchmoney-mcp-server"
],
"command": "npx",
"env": {
"LUNCHMONEY_TOKEN": "your_token_here"
}
}
}
}该服务需要配置环境变量：LUNCHMONEY_TOKEN
可用工具 （4 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
get-budget-summary 2 个参数 需填 2 项
Get budget summary for a specific time period
必填参数：start_date、end_date
get-recent-transactions 2 个参数
Get recent transactions
该工具无需必填参数，直接调用即可
search-transactions 3 个参数 需填 1 项
Search transactions by keyword
必填参数：keyword
get-category-spending 2 个参数 需填 1 项
Get spending in a category
必填参数：category
服务介绍
Lunchmoney MCP 服务器
一个模型上下文协议（MCP）服务器，让你可以通过 Claude 和其他 AI 助手与你的 Lunchmoney 交易和预算进行互动。
这是什么？
这个工具允许你将 Lunchmoney 财务数据连接到 Claude AI，这样你可以通过自然对话询问关于支出的问题、分析预算并获取财务见解。
功能
该服务器提供了四个主要工具：
- get-recent-transactions: 查看过去 N 天内的最近交易
- search-transactions: 通过收款人名称或备注中的关键字搜索交易
- 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 是一个软件平台，允许你在计算机上（浏览器之外）运行 JavaScript 代码。
要安装 Node.js：
- Windows/Mac: 从 官方 Node.js 网站 下载并运行安装程序
- Mac with Homebrew: 在终端中运行
brew install node - Linux: 使用你的包管理器（例如，对于 Ubuntu，使用
sudo apt install nodejs）
一旦在你的计算机上安装了 Node.js，你可以直接运行服务器而无需下载任何东西：
- 从你的 Lunchmoney 开发者设置 获取你的 Lunchmoney API 令牌
- 打开 Claude Desktop
- 转到 设置 → 开发者 ->
编辑配置 - 添加以下配置：
{
"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) 是一个开放协议，它标准化了应用程序向大型语言模型（LLMs）提供上下文的方式。可以将 MCP 视为 AI 应用程序的 USB-C 端口——它提供了一种将 AI 模型连接到不同数据源和工具的标准方式。
MCP 的一些主要优势包括：
- 标准化地向 LLMs 暴露数据和功能
- 人工参与的安全机制（所有操作都需要用户批准）
- 不断增长的预构建集成生态系统
- 支持多种 AI 模型和应用
故障排除
Claude 说无法连接到我的 MCP 服务器：
- 确保 Claude 开发者设置中的配置正确
- 尝试在更改配置后重启 Claude Desktop
- 检查您的 Lunchmoney API 令牌是否有效
Claude 不识别 Lunchmoney 命令：
- 在 Claude 中开始一个新的对话
- 尝试在查询中明确提及 Lunchmoney（例如，“显示我最近的 Lunchmoney 交易”）
API 注意事项
- 预算数据必须使用月份边界作为日期范围（例如，2024-01-01 至 2024-01-31）
- 交易可以使用任意日期范围
- 所有货币值都以其原始货币形式返回
许可证
MIT
贡献
欢迎贡献！请随时提交 Pull Request。
