电商智能代理

通过MCP(Model Context Protocol)连接的电商智能代理,实时查询产品信息、库存、价格等。

  • by FranckALPHA
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 FranckALPHA/MCP-Projet-

使用说明

🤖 MCP电子商务代理

通过MCP(模型上下文协议)连接的AI电子商务代理,允许客户实时查询产品、库存、价格等信息。

🏗️ 建筑

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Frontend      │    │   Backend MCP   │    │   Base de       │
│   (React +      │◄──►│   Server        │◄──►│   Données       │
│   Shadcn/ui)    │    │   (Node.js)     │    │   PostgreSQL    │
└─────────────────┘    └─────────────────┘    └─────────────────┘

🚀 快速启动

先决条件

  • Docker与Docker编写
  • Node.js 18+(用于本地开发)

安装

  1. 克隆项目

    git clone <repository-url>
    cd mcp-ecommerce-agent
    
  2. 配置环境

    cp env.example .env
    # Éditer .env avec vos configurations
    
  3. 开始使用Docker

    docker-compose up -d
    
  4. 访问应用程序

    • 前端:http://localhost
    • 后端API:http://localhost:3000
    • 数据库:本地主机:5432

📁 项目结构

/mcp-ecommerce-agent
  /backend              # Backend Node.js + Express + MCP
    /src
      /mcp             # Serveur MCP et agent IA
      /db              # Connecteur base de données
      /api             # Endpoints REST
      /security        # Authentification et autorisation
      /logs            # Système de logging
      /config          # Configuration
      /utils           # Utilitaires
    Dockerfile
    package.json
  /frontend            # Frontend React + Vite + Shadcn/ui
    /src
      /components      # Composants React
      /services        # Services API
      /hooks           # Hooks personnalisés
      /utils           # Utilitaires
    Dockerfile
    package.json
  docker-compose.yml
  env.example
  README.md

🛠️ 使用的技术

后端

  • Node.js + 快速 -框架web
  • 棱镜 -数据库的ORM
  • PostgreSQL -主数据库
  • 瑞迪斯 -缓存和会话
  • JWT -身份验证
  • 温斯顿 -日志记录
  • 主控程序 -模型上下文协议

前端

  • 反应18 + TypeScript -框架UI
  • 维特 -构建工具
  • Shadcn/ui -组件用户界面
  • 顺风CSS -造型
  • React查询 -服务器状态管理
  • 阿西奥斯 -客户端HTTP

开发运维

  • 码头工人 + Docker Compose -集装箱化
  • Nginx -反向代理
  • 埃斯林特 + 更漂亮 -代码质量

📚 文档

查阅文件 /docs 有关完整文档:

🧪 发展

后端

cd backend
npm install
npm run dev

前端

cd frontend
npm install
npm run dev

测试

# Backend
cd backend && npm test

# Frontend
cd frontend && npm test

📊 功能

  • [x] 前端/后端架构
  • [x]完整的Docker配置
  • [x]具有ShadCN/UI的现代用户界面
  • []具有MCP的代理IA
  • []数据库连接器
  • []认证系统
  • []集成聊天小部件
  • []个性化建议

🤝 贡献

  1. 分叉项目
  2. 创建功能分支(git checkout -b feature/AmazingFeature)
  3. 提交更改(git commit -m 'Add some AmazingFeature')
  4. 向分支推(git push origin feature/AmazingFeature)
  5. 打开拉取请求

📄 许可证

该项目获得MIT许可。查看文件 LICENSE 更多详情。

👨‍💻 作者

弗兰克·阿尔法 -初步发展


开发与❤️ 对于智能电子商务