使用说明
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包管理器。
设置和安装
-
克隆存储库:
git clone https://github.com/mohana9985/MCP_Dummy-Sales_Data_Generation.git cd dummy-sales-data -
设置环境:
- 创建一个
.env在根目录中创建文件,并添加以下内容:MYSQL_HOST=localhost MYSQL_USER=qtgenai MYSQL_PASSWORD=qtgenai MYSQL_DATABASE=genaicommerce
- 创建一个
-
使用Docker Desktop启动服务:
- 打开Docker桌面。
- 注: 这
docker-compose.yml使用arm64v8/phpmyadminMac 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交互。
- 打开终端并运行help命令以查看可用选项:
mcp --help - 安装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许可证获得许可。请参阅 许可证 文件以获取详细信息。