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 
   cd mcp-ecommerce-agent

1. 配置环境

   cp env.example .env
   # Éditer .env avec vos configurations

1. 开始使用Docker

   docker-compose up -d

1. 访问应用程序

- 前端：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 有关完整文档：

• 总体计划
• 步骤1-初始化
• 步骤2-DB连接器
• 步骤3-代理IA
• 步骤4-前端
• 步骤5-安全
• 步骤6-测试和部署
• 步骤7-演变

🧪 发展

后端

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 更多详情。

👨‍💻 作者

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

______________________________________________________________________

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