Lunchmoney MCP

🚀 Lunch Money MCP 服务器

这是一个用于 Lunch Money API 的 MCP（模型上下文协议）服务器，它允许人工智能助手与你的 Lunch Money 账户进行交互，以管理交易、类别、预算等。

✨ 主要特性

此 MCP 服务器提供对 Lunch Money 以下功能的访问：

• 用户：获取账户信息
• 类别：创建、读取、更新和删除类别
• 交易：管理交易（创建、读取、更新、过滤）
• 标签：获取所有标签
• 资产：管理账户/资产
• 预算：获取和更新预算
• 定期项目：获取定期交易
• Plaid 账户：管理连接的 Plaid 账户
• 加密货币：管理加密资产

📦 安装指南

选项 1：自动安装（更简单）🚀

python install.py

此脚本将：

• ✅ 自动安装软件包
• ✅ 询问你的 Lunch Money 令牌
• ✅ 自动配置 Claude Desktop
• ✅ 一切准备就绪，可直接使用

选项 2：手动安装

pip install lunchmoney-mcp

然后将以下配置添加到你的 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "lunchmoney": {
      "command": "lunchmoney-mcp",
      "env": {
        "LUNCHMONEY_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

就这么简单！ 🎉 和 Playwright MCP 一样容易。

获取访问令牌：

1. 访问 https://my.lunchmoney.app/developers
2. 创建一个新的访问令牌
3. 在上述配置中使用它

从源代码安装

如果你更喜欢从源代码安装：

1. 克隆仓库：

   git clone <repository-url>
   cd lunchmoney-mcp
   

2. 安装：

   pip install -e .
   

3. 在 Claude Desktop 中配置：

   {
     "mcpServers": {
       "lunchmoney": {
         "command": "lunchmoney-mcp",
         "env": {
           "LUNCHMONEY_ACCESS_TOKEN": "your_token_here"
         }
       }
     }
   }
   

配置文件位置：

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

💻 使用示例

配置完成后，你可以使用 Claude Desktop 与你的 Lunch Money 账户进行交互。以下是一些使用示例：

基础用法

1. 获取用户信息：

   "显示我的 Lunch Money 账户信息"
   

2. 查看所有类别：

   "列出我所有的 Lunch Money 类别"
   

3. 创建新类别：

   "在 Lunch Money 中创建一个名为 '娱乐' 的新类别"
   

4. 查看近期交易：

   "显示上个月的交易记录"
   

5. 创建交易：

   "为 'XYZ 超市' 添加一笔 50 美元的交易，类别为 '食品'"
   

6. 查看预算：

   "显示本月的预算摘要"
   

📚 详细文档

可用工具

用户

• get_user：获取用户和账户信息

类别

• get_all_categories：获取所有类别
• get_single_category：获取特定类别
• create_category：创建新类别
• update_category：更新现有类别
• delete_category：删除类别

交易

• get_all_transactions：获取所有交易（带过滤器）
• get_single_transaction：获取特定交易
• insert_transactions：插入新交易
• update_transaction：更新现有交易

标签

• get_all_tags：获取所有标签

资产

• get_all_assets：获取所有资产/账户
• create_asset：创建新资产/账户
• update_asset：更新现有资产

预算

• get_budget_summary：获取预算摘要
• upsert_budget：创建或更新预算数据

定期项目

• get_recurring_items：获取所有定期项目

Plaid 账户

• get_all_plaid_accounts：获取所有 Plaid 账户
• trigger_plaid_fetch：触发与 Plaid 的同步

加密货币

• get_all_crypto：获取所有加密资产
• update_manual_crypto：手动更新加密资产

🔧 技术细节

开发

若要为开发做出贡献：

1. 安装开发依赖项：

   pip install -e ".[dev]"
   

2. 运行测试：

   pytest
   

3. 格式化代码：

   black lunchmoney_mcp/
   

安全

• 切勿分享你的 Lunch Money 访问令牌
• 将令牌保存在 .env 文件中，并确保该文件在 .gitignore 中
• MCP 服务器在本地运行，不会将数据发送到外部服务

限制

• Lunch Money API 处于公开测试阶段，可能会有变更
• 某些操作可能有速率限制
• 通过 API 进行的更改不可逆转

支持

如果你遇到问题：

1. 验证你的访问令牌是否有效
2. 查阅 Lunch Money 官方文档
3. 检查 MCP 服务器日志以获取特定错误信息

📄 许可证

本项目采用 MIT 许可证。有关更多详细信息，请参阅 LICENSE 文件。

相关链接

• Lunch Money
• Lunch Money API 文档
• 模型上下文协议
• Claude Desktop