销售数据生成器

该项目生成虚拟销售数据并提供简单的API接口进行交互,适用于测试和开发场景。

  • by mohana9985
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 mohana9985/MCP_Dummy-Sales_Data_Generation

使用说明

MCP销售数据生成

该项目生成伪销售数据,并提供一个简单的API与之交互。它使用Docker运行MySQL数据库,phpMyAdmin用于数据库管理,并为API运行Python服务器。

目录

项目结构

该项目组织如下:

.
├── .env
├── .gitignore
├── .python-version
├── docker-compose.yml
├── ecommerce_db.sql
├── mcp_data_gen.py
├── pyproject.toml
├── README.md
├── utilis.py
└── uv.lock
  • .env:数据库连接的环境变量。
  • .gitignore:指定要忽略的故意未跟踪的文件。
  • .python-version:指定要使用的Python版本。
  • docker-compose.yml:Docker Compose配置用于设置MySQL数据库和phpMyAdmin。
  • ecommerce_db.sql:SQL脚本,用于创建数据库模式并用示例数据填充它。
  • mcp_data_gen.py:应用程序的主要入口点。包含用于生成伪数据和API终结点的逻辑。
  • pyproject.toml:Python项目配置文件。
  • README.md:这个文件。
  • utilis.py:实用程序功能,包括数据库连接。
  • uv.lock:的锁定文件 uv 包管理器。

设置和安装

  1. 克隆存储库:

    git clone https://github.com/mohana9985/MCP_Dummy-Sales_Data_Generation.git
    cd dummy-sales-data
    
  2. 设置环境:

    • 创建一个 .env 在根目录中创建文件,并添加以下内容:
      MYSQL_HOST=localhost
      MYSQL_USER=qtgenai
      MYSQL_PASSWORD=qtgenai
      MYSQL_DATABASE=genaicommerce
      
  3. 使用Docker Desktop启动服务:

    • 打开Docker桌面。
    • 注: 这 docker-compose.yml 使用 arm64v8/phpmyadmin Mac ARM64架构特有的镜像。如果您使用的是不同的架构(如Windows或非ARM Mac),则需要使用 phpmyadmin/phpmyadmin 图像代替。
    • 在终端中运行以下命令:
      docker-compose up -d
      
    • 这将启动Python API服务器、MySQL容器和phpMyAdmin容器。您可以访问phpMyAdmin http://localhost:8080.

用法

一旦服务在Docker中运行,API服务器将可用于处理请求。

与API交互

您可以使用任何API客户端与正在运行的服务器进行交互。例如,您可以使用Claude桌面应用程序向下面列出的API端点发送请求。

Claude桌面应用程序集成

安装Claude桌面应用程序后,您可以将其配置为与该项目的API交互。

  1. 打开终端并运行help命令以查看可用选项:
    mcp --help
    
  2. 安装MCP配置:
    mcp install mcp_dummy_gen.py
    
    注意:您需要更换 <filename> 使用此项目的实际配置文件。

配置后,您可以通过Claude桌面应用程序使用自然语言与API交互。

API终点

这 mcp_data_gen.py 脚本公开以下API终结点:

  • 获取 /products/latest:获取最新产品。
  • 获取 /products/selected/{name}:按名称获取产品。
  • 获取 /users/latest:获取最新用户。
  • 获取 /users/selected/{username}:按用户名获取用户。
  • 获取 /categories/latest:获取最新类别。
  • 获取 /categories/selected/{name}:按名称获取类别。
  • 发布 /products:创建新产品。
  • 删除 /products/{name}:按名称删除产品。
  • 发布 /users:创建新用户。

许可证

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