财务API服务器

午餐钱MCP服务器

用于 API午餐钱，允许人工智能助理与您的午餐钱账户互动，以管理交易、类别、预算等。

特征

该MCP服务器提供对以下午餐钱功能的访问：

• 用户：获取帐户信息
• 类别：创建、阅读、更新和删除类别
• 交易：管理事务（创建、读取、更新、筛选）
• 标签：获取所有标签
• 活动：管理账户/资产
• 预算：获取和更新预算
• 复发性元素：获取重复交易
• 格子珠子：管理连接的Plaid帐户
• 加密货币：管理加密资产

Instalación超级简单🚀

选项1：自动安装（更容易）

python install.py

Este脚本：

• ✅ 自动安装包
• ✅ 他要你的午餐钱代币
• ✅ 自动配置克劳德桌面
• ✅ 一切都准备好了

选项2：手动安装

pip install lunchmoney-mcp

然后将此设置添加到您的文件中 claude_desktop_config.json:

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

就这样！ 🎉 谭嗣同编剧MCP。

获取您的登录令牌：

1. Ve a 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": "tu_token_aqui"
         }
       }
     }
   }
   

配置文件位置：

• 视窗: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

谎言

一旦配置好，您可以使用Claude Desktop与您的午餐钱帐户进行交互。以下是一些例子：

使用示例

1. 获取用户信息：

   复制

   "Muéstrame la información de mi cuenta de Lunch Money"
   

2. 查看所有类别：

   复制

   "Lista todas mis categorías de Lunch Money"
   

3. 创建新类别：

   复制

   "Crea una nueva categoría llamada 'Entretenimiento' en Lunch Money"
   

4. 查看最近的交易：

   复制

   "Muéstrame las transacciones del último mes"
   

5. 创建交易：

   复制

   "Añade una transacción de $50 para 'Supermercado XYZ' en la categoría 'Comida'"
   

6. 查看预算：

   复制

   "Muéstrame el resumen del presupuesto de este mes"
   

可用的工具

用户

• 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：获取所有重复元素

格子珠子

• get_all_plaid_accounts：获取所有格子帐户
• trigger_plaid_fetch启用 Plaid 同步

加密货币

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

发展

为促进发展：

1. 安装开发依赖项：

   复制

   pip install -e ".[dev]"
   

2. 执行测试：

   复制

   pytest
   

3. 设置代码格式：

   复制

   black lunchmoney_mcp/
   

安全

• 永远不要分享你的午餐钱访问令牌
• 将您的令牌保存到文件中 .env 确保它在你的 .gitignore
• MCP服务器在本地运行，不向外部服务发送数据

限制

• Lunch Money的API是公开测试版的，因此可能会有变化
• 一些操作可能有速度限制
• 通过API进行的更改是不可逆转的

支持

如果您遇到问题：

1. 验证您的访问令牌是否有效
2. 咨询 午餐钱官方文件
3. 检查MCP服务器日志中的特定错误

许可证

这个项目是在麻省理工学院的许可下进行的。有关详细信息，请参阅许可证文件。

相关链接

• 午餐费
• 午餐钱API文档
• 模型上下文协议
• 克劳德桌面