信用卡优化平台

Chronos是一个AI驱动的信用卡奖励优化平台,通过分析消费模式和实时数据,为用户提供个性化的信用卡策略,最大化奖励收益。

  • by AnayaD
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 anayad/mcp-hackathon-m-a

使用说明

🏆 Chronos-人工智能信用卡优化平台

MCP AI黑客马拉松项目 -您的信用卡奖励个人人工智能策略师

🎯 问题

信用卡奖励已经成为一种复杂但极具价值的“游戏”。玩得好和根本不玩之间的区别可能是 每年数千美元 免费旅行、现金返还和福利。然而,游戏是针对普通人的:

  • 规则分散在数十个博客中
  • 隐藏在论坛帖子中的最佳策略
  • 最佳选择每月都在变化
  • 一小群“金融爱好者”与其他人

💡 解决方案:Chronos

Chronos扮演 伟大平衡器 -你的个人人工智能策略师,为你玩这个复杂的游戏。它需要曾经只有少数痴迷者才能获得的专业知识,并将其提供给每个人。

🚀 主要特点

🔍 后视图分析

  • 确定性奖励计算 准确显示你错过了什么
  • 过去交易和错失机会的详细细分
  • 按类别分析支出模式

🎯 自然语言目标输入

  • 用简单的英语告诉我们你的目标: “2025年5月巴黎之旅2500美元”
  • 人工智能解析自动提取结构化数据
  • MCP集成获取实时定价和评论

📊 智能规划

  • 信用卡时间线生成 根据你的消费模式
  • 为每个目标提供最佳卡片建议
  • 生活变化时的动态战略适应

🔄 实时数据集成

  • MCP服务器集成 使用Bright Data进行网页抓取
  • 实时信用卡优惠和旅行定价
  • 自动化数据收集和处理

🛠 技术栈

前端

  • ⚛️ 反应 与Vite携手快速发展
  • 🎨 顺风CSS 用于现代UI
  • 🔄 React路由器 用于导航
  • 📱 响应式设计 适用于所有设备

后端

  • 🚀 Express.js REST API
  • 🗄️ Redis云 用于数据存储和缓存
  • 🤖 OpenAI GPT 用于自然语言处理
  • 🔌 MCP协议 用于外部服务集成

外部服务

  • 🌐 Bright Data MCP服务器 用于网页抓取
  • 🧠 Llama指数 用于文档索引
  • 🔐 停止 用于身份验证
  • 📊 森索。 用于数据规范化

🏗 建筑

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   React Client  │    │  Express API   │    │  External APIs │
│                 │    │                 │    │                 │
│ • Login/Onboard │◄──►│ • Auth Routes   │◄──►│ • Bright Data   │
│ • Dashboard     │    │ • Data Routes  │    │ • OpenAI LLM    │
│ • Chat Interface│    │ • Chat Routes   │    │ • Redis Cloud   │
│ • Goal Planning │    │ • MCP Client    │    │ • Senso.ai      │
└─────────────────┘    └─────────────────┘    └─────────────────┘

🚀 快速开始

先决条件

  • Node.js 18+
  • Redis云帐户
  • OpenAI API密钥
  • Bright Data MCP访问

安装

  1. 克隆存储库
git clone https://github.com/AnayaD/MCP-Hackathon-M-A.git
cd MCP-Hackathon-M-A
  1. 安装依赖项
# Install root dependencies
npm install

# Install server dependencies
cd server && npm install

# Install client dependencies  
cd ../client && npm install
  1. 环境设置
# Copy environment template
cp server/env.example server/.env

# Add your API keys to server/.env
OPENAI_API_KEY=your_openai_key
REDIS_URL=your_redis_url
BRIGHTDATA_API_KEY=your_brightdata_key
# ... other keys
  1. 运行应用程序
# Start both client and server
npm run dev

# Or start individually:
# Server: cd server && node index.js
# Client: cd client && npm run dev
  1. 访问应用程序
  • 前端:http://localhost:3000
  • 后端API:http://localhost:3001
  • 健康检查:http://localhost:3001/api/health

📱 用户旅程

1.启示录(后视镜)

“去年,你错过了大约1250美元的奖励。”

用户可以清楚地看到他们错过了什么——他们预订的航班、他们购买的杂货——在那里,不同的选择可以解锁巨额奖金。

2.对话(未来目标)

“我想计划明年五月的周年纪念日去巴黎旅行。”

自然语言输入被解析为具有实时定价数据的结构化目标。

3.战略(分叉路径)

“10月:申请X卡。1月:80000积分奖励。2月:预订航班。”

AI提供了最佳的信用卡时间表和可操作的步骤。

4.适应(生活计划)

“事实上,我还需要在11月买一台新笔记本电脑。”

系统会立即重新评估并提出更好的策略。

🔧 API终点

认证

  • POST /api/auth/login -用户登录
  • POST /api/auth/logout -用户注销

数据管理

  • POST /api/data/store-profile -存储用户配置文件
  • POST /api/data/store-goals -使用MCP数据存储目标
  • GET /api/data/goals/:user_id -检索用户目标
  • POST /api/data/calculate-rewards -计算错过的奖励
  • POST /api/data/generate-timeline -生成信用卡时间线

聊天和计划

  • POST /api/chat/message -向AI战略家发送消息
  • POST /api/chat/parse-goals -解析自然语言目标

服务

  • GET /api/services/status -检查服务运行状况
  • POST /api/services/scrape/offers -取消信用卡优惠
  • POST /api/services/scrape/travel -取消旅行价格

🎯 MCP集成

该项目利用 模型上下文协议(MCP) 与外部服务无缝集成:

  • Bright Data MCP服务器 用于实时网页抓取
  • 结构化数据摄取 以及标准化
  • 自动化上下文管理 对于AI代理
  • 实时数据提取 目标和报价

📊 演示数据

该应用程序包括全面的演示数据:

  • 15笔详细的错过奖励交易 包含商家、类别、金额和推荐
  • 示例目标 用于旅行、技术和活动
  • 信用卡优化计划 具有时间线和点计算功能
  • 现实的支出模式 以及奖励计算

🏆 黑客马拉松成就

✅ 使用3+赞助商工具:

  • Redis云(矢量数据库)
  • 明亮数据(MCP Web剪贴)
  • OpenAI(LLM集成)
  • Senso.ai(数据标准化)
  • LlamaIdex(文档索引)

✅ 已实现的核心功能:

  • 自然语言目标输入
  • 确定性奖励计算
  • 实时MCP数据提取
  • 信用卡时间线生成
  • 全面的演示数据

✅ 技术卓越:

  • 全栈React+Express应用程序
  • Redis数据库集成
  • MCP协议实现
  • 专业的UI/UX设计

🤝 贡献

这是一个黑客马拉松项目,但欢迎投稿!拜托:

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 提交拉取请求

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

👥 团队

为 MCP AI黑客马拉松2025 Chronos团队。


准备好优化您的信用卡奖励了吗? 🚀

现场演示 | API文件 | GitHub