Shopops Mcp

ShopOps MCP

用于管理 Shopify 和 WooCommerce 商店的 AI 驱动型服务，实现了 Model Context Protocol（MCP）。

---

功能

• 商店连接器，支持 Shopify 和 WooCommerce。
• 12 个 MCP 工具，涵盖库存、定价、客户、订单、产品表现和报告。
• 4 个 MCP 资源，提供商店概览、库存、近期订单和顶级客户信息。
• 使用移动平均需求加安全库存计算进行库存预测。
• 基于 RFM 的客户细分（7 个不同细分群体）。
• 数据驱动的定价分析，并提供基于利润率的优化建议。
• 订单异常／欺诈检测。
• 产品表现 ABC 分析。
• 自动生成每日和每周报告。
• 双传输方式：本地 stdio 和 Streamable HTTP（MCPize）。
• TypeScript、@modelcontextprotocol/sdk v1.29+、Zod v4。
• 免费层级，以及售价 €29 的终身 Pro 许可证。

---

快速开始

# 1. Install the package
npm i shopops-mcp

# 2. Create a .env file (see Configuration section)
cp .env.example .env

# 3. Run the server (local stdio mode)
npx shopops-mcp run --transport stdio

# 4. Or start the HTTP endpoint (MCPize deployment)
npx shopops-mcp run --transport http --port 8080

服务将读取环境变量，连接到配置的商店，并提供 MCP 工具和资源。

---

MCP 工具

工具	说明
store_connect	连接、列出、断开或同步 Shopify/WooCommerce 商店（action: "connect" | "list" | "disconnect" | "sync"），并验证凭据。
store_demo_seed	创建逼真的演示商店（20 个产品、40 位客户、150 多个订单），让你无需真实商店凭据即可探索所有工具。
inventory_status	返回当前库存量、缺货回补标记和低库存提醒。
inventory_forecast	使用移动平均需求和安全库存缓冲预测未来库存需求。
pricing_analyze	生成价格弹性报告，并识别定价过低或过高的 SKU。
pricing_optimize	基于利润率分析、销售速度和可配置定价规则，建议最优价格。
customers_segment	执行 RFM 分析，并将客户划分到七个细分群体之一。
customers_churn	评估客户流失风险，并提供客户留存建议。
order_anomalies	使用模式识别模型检测潜在欺诈或错误订单。
product_performance	执行 ABC 分析，并返回各产品类别的贡献指标。
report_daily	生成 JSON/CSV 格式的每日运营摘要（销售、库存、提醒）。
report_weekly	生成包含趋势可视化内容的每周表现报告。

---

MCP 资源

资源	说明
store://overview	商店关键指标：每个已连接商店的产品、订单和客户数量。
store://inventory	低库存提醒：现存数量 ≤ 10 的在售产品，按库存从低到高排序。
store://orders/recent	所有商店最近的 20 个订单，包含订单号、总金额、状态和日期。
store://customers/top	按总消费额排名的前 20 位客户，包含姓名、邮箱和订单数量。

---

配置

ShopOps 只读取少量环境变量。商店凭据不是环境变量——它们会在运行时传递给 store_connect 工具（每个商店建立一个连接），因此同一服务器进程可以管理多个 Shopify/WooCommerce 商店。

变量	必需	描述
PORT	否	如果设置了该变量（或设置了 MCPIZE=true），服务器将在此端口上作为 Streamable HTTP 端点运行（默认值为 8080），而不是使用本地 stdio。
MCPIZE	否	由 MCPize 运行时设置为 true，以强制使用 HTTP 传输。
LEMONSQUEEZY_LICENSE_KEY	否	Pro 许可证密钥。未设置时，服务器将运行于免费层级（参见Pro 许可证）。

.env.example 中提供了一个最简 .env 文件。

连接商店

Shopify 和 WooCommerce 凭据以参数形式传递给 store_connect，例如：

// Shopify
{ "action": "connect", "platform": "shopify",
  "store_domain": "myshop.myshopify.com", "access_token": "shpat_..." }

// WooCommerce
{ "action": "connect", "platform": "woocommerce",
  "store_url": "https://example.com", "consumer_key": "ck_...", "consumer_secret": "cs_..." }

store_connect 会返回一个 store_id，所有其他工具都需要将其作为输入。若要在没有真实凭据的情况下探索服务器，请改为调用 store_demo_seed。

路线图（尚未实现）： 报告匿名化、S3 报告导出以及可配置的定价模型／日志级别均已列入计划，但当前版本不会读取这些设置。

---

Pro 许可证

ShopOps 以免费模式提供——store_demo_seed、store_connect、inventory_status、pricing_analyze、customers_segment、product_performance 和 report_daily 均可免费使用。以下工具需要 Pro 许可证：

• inventory_forecast — 移动平均需求预测 + 再订货点
• pricing_optimize — 可执行的价格调整建议
• customers_churn — 客户流失风险评分 + 留存建议
• order_anomalies — 欺诈／异常检测
• report_weekly — 周环比趋势报告 + AI 洞察

购买 Pro 许可证（€29，终身使用，支持 3 台设备）： https://automatiabcn.lemonsqueezy.com/buy/cbbe44f0-a146-4c65-88c8-71f371037758

也可购买 Indie MCP Stack Bundle（€69，包含全部 4 个服务器）。

export LEMONSQUEEZY_LICENSE_KEY=YOUR-KEY-HERE

或者在 MCP 客户端配置中：

{
  "mcpServers": {
    "shopops-mcp": {
      "command": "npx",
      "args": ["-y", "shopops-mcp-server"],
      "env": { "LEMONSQUEEZY_LICENSE_KEY": "YOUR-KEY-HERE" }
    }
  }
}

验证结果会在本地缓存 24 h——首次运行后即可完全离线使用。

---

许可证

ShopOps MCP 采用 MIT License 发布。完整条款请参阅 LICENSE。

---

作者：Automatia BCN