TrackExpensio
由FastMCP、LangGraph和Groq AI提供支持的完整金融智能助理。通过自然语言跟踪支出、管理预算、分析投资并获得AI驱动的见解。
特性
- 💰 费用跟踪 -通过聊天或自动分类的表单添加费用
- 📊 预算管理 -设置预算并获得实时警报
- 📈 雅虎金融整合 -获取实时股票和共同基金数据
- 🧾 文档处理 -上传收据/账单，AI自动提取费用明细
- 💬 AI聊天助手 -所有财务操作的自然语言界面
- 🔐 谷歌OAuth -具有数据持久性的安全登录
快速开始
先决条件
- Python 3.10+
- MongoDB（本地或云端）
- Groq API密钥(在这里买一个)
安装
- 克隆存储库：
git clone
cd project- 创建虚拟环境（推荐）：
python -m venv venv
venv\Scripts\activate # Windows
# or
source venv/bin/activate # Linux/Mac- 安装依赖项：
pip install -r requirements.txt- 设置环境变量：
创建一个 .env 项目根目录中的文件：
MONGODB_URI=mongodb://localhost:27017
MONGODB_DB=ai_expense_tracker
GROQ_API_KEY=your_groq_api_key_here
GROQ_AGENT_MODEL=llama-3.3-70b-versatile
# Optional: Google OAuth (for login)
GOOGLE_CLIENT_ID=your_client_id
GOOGLE_CLIENT_SECRET=your_client_secret
GOOGLE_REDIRECT_URI=http://127.0.0.1:8080/auth/google/callback
GOOGLE_PROJECT_ID=your_project_id运行应用程序
对于Web应用程序（推荐）：
python run_app.py或者使用自动重新加载进行开发：
python run_app.py --reload服务器将在以下时间启动 http://127.0.0.1:8080
重要提示： 对于web应用程序，请始终使用 run_app.pyMCP工具已集成到FastAPI端点中(/api/mcp/{tool_name})，因此您不需要单独的MCP服务器。
独立MCP服务器（可选-仅适用于MCP协议客户端）：
# STDIO mode (for Claude Desktop)
python mcp_server.py
# HTTP/SSE mode (for direct MCP protocol access)
python mcp_server.py --transport http --host 0.0.0.0 --port 8000
python mcp_server.py --transport sse --host 0.0.0.0 --port 8000注： 独立服务器使用MCP协议，该协议不同于FastAPI REST API。对于web应用程序，请使用 run_app.py.
项目结构
main.py-MCP服务器，配备所有财务工具（费用、预算、投资等）mcp_server.py-独立MCP服务器入口点（用于MCP协议客户端）api.py-FastAPI web服务器和客户端接口chat_agent.py-基于LangGraph的AI聊天代理services/-RAG处理和存储公用设施static/-前端资产（CSS、JavaScript）templates/-HTML模板
可用工具
MCP服务器提供 40+金融工具 包括：
- 费用管理（添加、列出、汇总、删除、更新）
- 预算管理（设置预算、检查状态）
- 收入跟踪（添加、列出、汇总）
- 储蓄目标（设定目标，跟踪进度）
- 债务管理（添加债务、记录付款、获取摘要）
- 投资跟踪（添加投资、更新价值、投资组合）
- 雅虎财经集成（实时股票数据）
- 文档处理（基于RAG的收据解析）
- 账单提醒（添加提醒，获取即将到来的账单）
- 财务报告（综合报告）
- 税务估算
- 信用评分跟踪
- 多币种支持
- 银行整合框架
用法
- 打开
http://127.0.0.1:8080在浏览器中 - 自动创建访客会话
- 使用AI聊天：
- “今天大巴扎的杂货加500卢比” - “显示我本月的支出” - “AAPL股票的价格是多少？” - “为食品类别设定5000的预算”
- 或者使用UI部分进行手动输入
API终点
POST /api/chat-与AI助手聊天POST /api/mcp/{tool_name}-直接调用MCP工具POST /api/session/create-创建访客会话GET /api/user/profile-获取用户资料（登录谷歌后）
许可证
麻省理工学院