Lunchmoney Mcp

金融 Python

🚀 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 一样容易。

获取访问令牌：

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

从源代码安装

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

克隆仓库：
```
git clone 
cd lunchmoney-mcp
```
安装：
```
pip install -e .
```

在 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 账户进行交互。以下是一些使用示例：

基础用法

获取用户信息：

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

查看所有类别：

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

创建新类别：

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

查看近期交易：
```
"显示上个月的交易记录"
```

创建交易：

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

查看预算：
```
"显示本月的预算摘要"
```

📚 详细文档

可用工具

用户

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_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：手动更新加密资产

🔧 技术细节

开发

若要为开发做出贡献：

安装开发依赖项：
```
pip install -e ".[dev]"
```
运行测试：
```
pytest
```
格式化代码：
```
black lunchmoney_mcp/
```

安全

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

限制

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

支持

如果你遇到问题：

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

📄 许可证

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