MCP Dummy-Sales Data Generation

MCP销售数据生成

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

目录

• 项目结构
• 设置和安装
• 用法
• 与API交互
• Claude桌面应用程序集成
• API终点
• 许可证

项目结构

该项目组织如下：

.
├── .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

1. 设置环境：

- 创建一个 .env 在根目录中创建文件，并添加以下内容：

     MYSQL_HOST=localhost
     MYSQL_USER=qtgenai
     MYSQL_PASSWORD=qtgenai
     MYSQL_DATABASE=genaicommerce

1. 使用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

1. 安装MCP配置：

   mcp install mcp_dummy_gen.py

*注意：您需要更换 `` 使用此项目的实际配置文件。*

配置后，您可以通过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许可证获得许可。请参阅 许可证 文件以获取详细信息。