MCP服务器:电子商务分析
MCP(模型上下文协议)服务器,使Claude可以直接访问电子商务SQLite数据库。询问有关销售、客户、库存和订单的自然语言问题——克劳德会自动调用正确的工具。
与官方合作建造 拟人化MCP Python SDK 并设计为单文件、零配置演示。数据库是在第一次运行时创建的,并播种了真实的数据。
特性
| 工具 | 说明 |
|---|---|
query_sales_report | 任何日期范围的收入、订单数、平均订单价值和顶级产品。可选类别筛选器。 |
get_customer_insights | 完整的客户资料:购买历史、终身消费、最喜欢的类别、最近的订单。通过ID或电子邮件查找。 |
check_inventory_status | 每种产品的库存水平都有低库存警报。可选类别过滤器和可配置阈值。 |
search_orders | 按状态、客户电子邮件和最低金额灵活搜索订单。带有项目计数的分页结果。 |
get_business_summary | 高级仪表板:总收入、按类别划分的收入、6个月趋势和前5名客户。 |
快速开始
1.安装依赖项
pip install -r requirements.txt2.直接运行服务器(stdio传输)
python server.py首次运行时,服务器创建 ecommerce_demo.db 在同一目录中,并为其添加种子:
- 50产品 涵盖5个类别(电子、服装、家居与厨房、书籍、体育)
- 200客户 具有真实的姓名、电子邮件和注册日期
- 1200个订单 具有不同的状态,每个状态有1-5行项目
3.连接到克劳德桌面
将以下内容添加到您的Claude Desktop配置文件中:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 窗户:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"ecommerce-analytics": {
"command": "python",
"args": ["/absolute/path/to/server.py"]
}
}
}重新启动克劳德桌面。工具将自动显示。
查询示例
连接后,试着问克劳德:
- “给我看过去30天的销售报告。”
- “本季度电子类表现如何?”
- “通过电子邮件查找客户james.smith@example.com."
- “哪些产品库存不足?”
- “查找所有超过100美元的待处理订单。”
- “给我一份总体业务总结和趋势。”
Claude将选择适当的工具,执行查询,并以可读的格式呈现结果。
技术栈
- Python 3.10+
- MCP Python SDK (
mcp带FastMCP的软件包) - Pydantic v2 用于响应验证
- SQLite (零配置,基于文件)
项目结构
mcp-server-ecommerce-analytics/
server.py # MCP server -- tools, DB setup, entry point
requirements.txt # Python dependencies
README.md # This file
ecommerce_demo.db # Auto-generated on first run许可证
麻省理工学院
