MoneyMate:人工智能个人理财助理
MoneyMate是一套创新的人工智能驱动工具,旨在彻底改变个人财务管理。该项目采用MCP(模块化能力提供商)集成和WhatsApp连接构建,提供全面的财务跟踪、分析和智能见解,帮助用户实现财务目标。
🚀 主要特点
MoneyMate提供15种专门的财务工具,每种工具都旨在解决个人财务管理的特定方面:
🔐 用户管理
- 用户注册和身份验证:使用密码哈希和WhatsApp号码链接保护用户帐户
- 会话管理:为所有财务操作提供安全的用户环境
💰 费用管理
- 费用记录器:通过分类和付款方式跟踪日常开支
- 票据OCR解析器:使用AI从账单图像/PDF中自动提取费用明细
- 月度总结:具有趋势和见解的全面支出分析
- 费用异常检测器:人工智能驱动的异常支出模式检测
📊 预算与规划
- 预算规划师:跨类别和时间段设置和管理预算
- 可负担性检查器:明智地分析采购是否符合预算和目标
- 经常性费用经理:通过提醒跟踪订阅和定期付款
📈 投资与投资组合
- Zerodha投资组合提取器:实时投资组合数据和损益跟踪
- Zerodha订单下达器:通过Zerodha API执行买卖订单
- 投资总结:包括所有资产和投资在内的综合净值
🎯 目标与节省
- 储蓄目标跟踪器:有动力地设定、跟踪和实现财务目标
- 预算问答:具有人工智能响应的自然语言财务查询
🔔 智能通知
- 警报通知器:预算限制、市场变化和目标进展的智能警报
💡 为什么选择MoneyMate?
在当今复杂的金融环境中,MoneyMate将尖端的人工智能与实用工具相结合,以:
- 简化财务:自动化费用跟踪和分类
- 提供见解:基于人工智能的支出模式和趋势分析
- 实现明智决策:可负担性检查和预算建议
- 跟踪进度:储蓄和投资目标的可视化进度跟踪
- 保持消息灵通:重要金融事件的实时警报和通知
🏗️ 项目结构
MoneyMate/
├── mcp-bearer-token/
│ ├── mcp_starter.py # Main MCP server with all finance tools
│ └── tools/ # Individual finance tool implementations
│ ├── register_user.py # User registration and authentication
│ ├── login_user.py # User login and session management
│ ├── expense_logger.py # Expense tracking and logging
│ ├── bill_ocr_parser.py # AI-powered bill parsing
│ ├── monthly_summary.py # Spending analysis and insights
│ ├── budget_planner.py # Budget setting and management
│ ├── affordability_checker.py # Purchase affordability analysis
│ ├── zerodha_portfolio_fetcher.py # Portfolio tracking
│ ├── zerodha_order_placer.py # Trading execution
│ ├── investment_summary.py # Net worth calculation
│ ├── savings_goal_tracker.py # Goal tracking
│ ├── expense_anomaly_detector.py # Spending pattern analysis
│ ├── recurring_expense_manager.py # Subscription tracking
│ ├── budget_question_answerer.py # AI financial advisor
│ └── alert_notifier.py # Smart notifications
├── requirements.txt # Python dependencies
├── pyproject.toml # Project configuration
└── README.md # This file🛠️ 安装和设置
先决条件
- Python 3.11或更高版本
- WhatsApp商务API访问(用于通知)
- Zerodha API证书(用于交易功能)
- Groq API密钥(用于AI供电功能)
1.克隆存储库
git clone https://github.com/yourusername/moneymate.git
cd moneymate2.安装依赖项
# Create virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install packages
pip install -r requirements.txt3.配置环境变量
创建一个 .env 根目录中的文件:
# MCP Server Configuration
AUTH_TOKEN=your_auth_token_for_mcp
MY_NUMBER=your_whatsapp_validation_number
# AI Services
GROQ_API_KEY=your_groq_api_key
# Zerodha Trading API
ZERODHA_API_KEY=your_zerodha_api_key
ZERODHA_SECRET=your_zerodha_secret
ZERODHA_USER_ID=your_zerodha_user_id
ZERODHA_PASSWORD=your_zerodha_password
ZERODHA_PIN=your_zerodha_pin
# Optional APIs
GOOGLE_API_KEY=your_google_api_key
TAVILY_API_KEY=your_tavily_api_key4.运行服务器
cd mcp-bearer-token
python mcp_starter.py服务器启动于 http://0.0.0.0:8086 所有金融工具均已注册并准备就绪。
📱 使用示例
用户注册
# Register new user
await register_user(
username="john_doe",
password="secure_password123",
whatsapp_number="+919876543210"
)费用跟踪
# Log an expense
await expense_logger(
user_id="user_123",
amount=850.00,
category="food",
description="Restaurant dinner",
date="2024-01-15",
payment_method="credit_card"
)
# Parse bill image
await bill_ocr_parser(
user_id="user_123",
image_data="base64_encoded_image",
description="Lunch receipt"
)预算管理
# Set monthly budget
await budget_planner(
user_id="user_123",
category="food",
amount=5000.00,
period="monthly"
)
# Check affordability
await affordability_checker(
user_id="user_123",
purchase_amount=2500.00,
category="electronics",
urgency="medium"
)投资组合管理
# Fetch portfolio
await zerodha_portfolio_fetcher(user_id="user_123")
# Place trade order
await zerodha_order_placer(
user_id="user_123",
symbol="RELIANCE",
quantity=10,
order_type="BUY",
price=2500.00,
order_variety="LIMIT"
)🔧 API集成
MCP服务器
MoneyMate作为MCP服务器运行,通过RESTful API公开所有工具,该API可以集成:
- Puch AI或其他AI平台
- 移动应用程序
- Web仪表板
- 第三方金融服务
WhatsApp集成
- 从图像消息中自动解析账单
- 实时财务警报和通知
- 交互式财务查询和答复
数据库
- 用于本地数据存储的SQLite数据库
- 用户身份验证和会话管理
- 全面的财务数据跟踪
🌟 关键利益
- AI驱动的洞察:利用Groq AI进行智能财务分析
- 自动跟踪:基于OCR的账单解析和费用分类
- 智能预算:人工智能驱动的预算建议和可负担性检查
- 投资组合管理:实时投资跟踪和交易功能
- 目标的实现:视觉进度跟踪和激励见解
- 安全:安全的用户身份验证和数据隐私
- 可扩展性:MCP架构,易于集成和扩展
🚧 当前状态
- ✅ 实施核心财务工具
- ✅ MCP服务器集成完成
- ✅ 数据库模式和用户管理
- ✅ 人工智能驱动的分析和见解
- 🔄 WhatsApp集成(模拟)
- 🔄 Zerodha API集成(模拟)
🔮 未来的增强功能
- 实时市场数据:实时股票价格和市场更新
- 高级分析:用于支出预测的机器学习
- 税收优化:自动化税务规划和优化
- 多币种支持:国际财务管理
- 移动应用程序:本地移动应用程序
- API市场:第三方金融服务集成
🤝 贡献
我们欢迎捐款!请参阅我们的投稿指南:
- 代码样式和标准
- 测试要求
- 文档更新
- 功能请求和错误报告
📄 许可证
MIT许可证-有关详细信息,请参阅许可证文件。
📞 支持
- GitHub问题:用于错误报告和功能请求
- 文档:全面的API文档
- 社区:加入我们的Discord/Telegram进行讨论
🙏 致谢
- 内置FastMCP,实现无缝MCP集成
- 由Groq AI提供智能金融见解
- 与Zerodha集成,用于印度市场交易
- 用于用户通信的WhatsApp Business API
______________________________________________________________________
MoneyMate -您的人工智能金融伴侣,实现更智能的资金管理! 💰✨
