Professional Finance Tracker

基本能力

产品定位

Professional Finance Tracker 是一个财务管理工具，旨在帮助用户跟踪和管理个人或企业的财务数据。

核心功能

• 加载财务数据：从 CSV 文件导入收入和支出数据。
• 支出跟踪：通过自然语言描述自动分类和检测支出来源。
• 预算监控：查看月度预算、总支出和剩余资金。
• 支出查询：按类别检索特定月份的详细支出明细。
• 预定义类别：支持如食品、交通和娱乐等类别及其相关来源。
• 服务器接口：使用 FastMCP 进行交互式财务数据管理。

适用场景

• 个人财务管理
• 企业预算监控
• 财务数据分析

工具列表

1. Query Expenses：查询特定月份的总支出和分类明细。
2. Add Expense：通过描述添加支出并自动分类。
3. Budget Status：显示特定月份的预算、总支出和剩余资金。

常见问题解答

• 依赖问题：确保 fastmcp 库可用，否则需联系项目维护者或使用替代框架。
• CSV 文件格式：必须包含指定的列（如 month, type, category, amount, source, date, description）。
• 描述解析：描述中必须包含明确的金额（如 "$10" 或 "10 dollars"）。

使用教程

使用依赖

1. 安装 Python 3.8+。
2. 安装依赖包： bash uv pip install pandas
3. 确保 fastmcp 库可用。

安装教程

1. 克隆仓库（如适用）： bash git clone <repository-url> cd professional-finance-tracker
2. 准备 CSV 文件：将 finances_example_export.csv 放入脚本目录。
3. 运行应用： bash python finance_tracker.py

调试方式

1. 检查 CSV 文件格式是否正确。
2. 确保描述中包含明确的金额。
3. 监控内存使用情况以优化 pandas 操作。

许可证

该项目遵循 None 开源许可条款。