AI导哈

电商数据分析服务

MCP Server是一款基于SQLite数据库的电商数据分析服务，可通过自然语言查询获取销售、客户、库存和订单等商业数据。

  • by ryu-tada
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 john1224530/mcp-server-ecommerce-analytics

使用说明

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.txt

2.直接运行服务器（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

许可证

麻省理工学院

相关 MCP