AI导哈

费用追踪MCP服务器

一个基于模型上下文协议（MCP）的服务器，用于管理个人费用，包括预算跟踪、分析和智能提醒。

  • by Coder8710
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Coder8710/Expense-Tracker-MCP-server

使用说明

💰 费用跟踪MCP服务器

一个模型上下文协议（MCP）服务器，用于通过预算跟踪、分析和智能警报管理个人开支。

✨ 特性

  • 💸 费用管理 -使用智能分类添加、更新、删除和列出费用
  • 📊 分析 -月度趋势、主要支出和类别细分
  • 💰 预算跟踪 -设置预算，并在达到阈值时自动发出警报
  • 🔄 经常性支出 -自动跟踪常规账单（首次自动添加）
  • 📤 数据导出 -导出为CSV/JSON文件以供外部分析
  • ✅ 智能验证 -全面的输入验证和错误处理

🔧 技术栈

核心框架

  • FastMCP -模型上下文协议服务器框架
  • Python 3.13+ -现代Python

数据库

  • SQLite3 -用于本地存储的轻量级嵌入式数据库

📁 项目文件

local_mcp_server.py
核心MCP服务器实现，包含所有16个工具、数据库初始化、验证逻辑和MCP资源/提示定义。使用同步SQLite3并通过stdio传输运行，非常适合与Claude Desktop在本地使用。这是启动FastMCP服务器并处理所有费用操作的入口点。

remote_mcp_server_async.py
服务器的异步变体 aiosqlite 以实现高效的并发数据库访问。专为远程和云部署而设计。使用自动检测数据库的可写目录 DATA_DIR 环境变量，回退到脚本目录或 /tmp 根据需要。

categories.json
用于验证和组织的预定义支出类别和子类别。此文件可确保所有费用的分类一致，并可根据需要进行自定义以添加新的类别或子类别。

费用.db （自动生成）
首次运行时自动创建的SQLite数据库文件。存储所有费用交易记录、预算配置和经常性费用定义。受.gitignore保护，保护您的财务数据隐私。

🐳 Docker镜像

Docker Hub上提供了此本地mcp服务器的预构建Docker映像，无需进行本地Python设置（Docker映像是公开的，您还可以在此Github存储库中的“Expense Tracker mcp server dockerized”目录中探索Docker映像是如何构建的）。 创建docker容器，然后您可以将此MCP服务器与Claude Desktop一起使用。

docker pull coder980/expense-tracker-mcp-server

🗂️ 可用的MCP工具

费用管理工具（5）

  1. 添加费用 -通过自动预算检查和警报添加新费用
  2. list_费用 -列出带有日期范围和类别过滤器的费用
  3. 更新_费用 -更新现有费用的任何字段
  4. 删除_费用 -按ID、多个ID、日期范围、类别或全部删除
  5. 总结 -获取按类别分类的支出汇总和总计

分析工具（3）

  1. 每月趋势 -特定年份的月度支出趋势
  2. get_top_expenses -查找日期范围内的最高费用
  3. get_category_breakdown -按类别和子类别进行分层细分

预算管理工具（4）

  1. set_budget -设置带有警报阈值的月度预算限制
  2. get_budget_status -检查特定月份（YYYY-MM）的预算状态
  3. list_budgets -查看所有已配置的预算
  4. 删除预算 -删除类别的预算

经常性费用工具（3）

  1. add_recurring_费用 -创建经常性费用（自动将第一个实例添加到费用中）
  2. 列表_经常性_费用 -查看所有经常性费用（活动/全部）
  3. 停用_回收_费用 -禁用经常性支出

数据导出工具（1）

  1. export_to_file -将费用导出到CSV或JSON文件

总计：16个MCP工具

🏷️ 分类

系统支持预定义的费用类别，包括：

  • 食物 -杂货、外出就餐、咖啡、小吃
  • 运输 -燃料、公共交通、停车、通行费
  • 住房 -租金、维修费、水电费、修理费
  • 健康 -药物、医生就诊、诊断
  • 娱乐 -电影、流媒体、体育、爱好
  • 购物 -服装、电子产品、个人护理
  • 保险 -生活、车辆、家、健康
  • 教育 -书籍、课程、订阅

🎯 关键能力

智能预算管理

当您添加费用时，系统会自动检查您是否接近或超过该类别的预算限制。当您越过设定的阈值（默认80%）时，您会收到即时警报。

自动重复跟踪

设置经常性费用会自动创建费用列表中的第一个实例。该系统跟踪每月、每周、每天或每年的经常性账单。

灵活的数据操作

按日期范围、类别或一次全部删除费用。在不影响其他字段的情况下更新费用的任何字段。跨多个维度过滤和搜索费用。

综合分析

通过每月趋势跟踪一段时间内的支出模式，确定主要支出，并获得详细的类别细分，准确显示您的资金流向。

数据可移植性

将您的财务数据导出为CSV或JSON格式，以便在电子表格或其他工具中进行进一步分析。

📊 用例

  • 通过分类跟踪日常个人开支
  • 根据月度预算监控支出
  • 分析财务趋势和模式
  • 管理经常性账单和订阅
  • 导出财务规划数据
  • 通过自然语言查询获得AI驱动的见解

相关 MCP