AI导哈

商业数据分析服务器

Commerce Layer Metrics MCP Server 是一个本地MCP服务器实现，提供了一套用于Commerce Layer数据分析的指标工具，支持从订单、退货或购物车历史中提取各种数据信息。

  • by commercelayer
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 commercelayer/mcp-server-metrics

使用说明

商务层度量MCP服务器

此存储库提供了一个本地MCP服务器实现，其中包含一套用于商务层数据分析的度量工具。

目录

概述

Metrics Local MCP Server公开了一组与Commerce层交互的工具 指标API 并使您能够从组织的订单、退货或购物车历史中提取几乎任何类型的数据信息。

安装

来自GIT存储库

  1. 克隆存储库：

    git clone https://github.com/your-org/mcp-server-metrics.git
cd mcp-server-metrics

  2. 安装依赖项：

    pnpm install

  3. 构建项目：

    pnpm build

  4. 创建服务器：

    pnpm dist

    编译后的文件将在 dist/ 目录，可用于在首选AI代理中设置MCP本地服务器(克劳德后退，OpenAI聊天GPT。..).

作为克劳德桌面扩展

Claude Dekstop现在可以轻松安装自定义MCP本地服务器，既可以作为预构建的捆绑包，也可以作为未打包的扩展包。 这里 您可以从Anthropic的支持人员那里找到执行安装的说明。

按照从GIT存储库安装的步骤进行操作，然后：

  1. 创建扩展包：

    npm run mcpb

  2. 安装扩展： 上传打包的扩展，从中获取捆绑包 mcpb/commercelayer-metrics.mcpb

根据要求插入 客户端id 和 客户端密码 连接到您的Commerce Layer组织。

工具

查询

这些工具允许您检索以下指标数据和统计数据 订单, 手推车 和 回报 通过四种类型的查询：

  1. 故障
  • 订单明细
  • 推车故障
  • 退货明细

分解是将数据汇总为度量（基于特定运算符）或统计数据的聚合，这些度量或统计数据是根据字段值计算的。当对Metrics API端点执行细分查询时，您会在响应中获得所选字段上的计算值（基于所选运算符），并由另一个字段聚合。

  1. 日期细分
  • 订单日期明细
  • 购物车日期细分
  • 退货日期明细

日期细分是一种聚合，显示数据集中特定日期值的出现频率，并允许您在该日期存在的记录的选定字段上应用特定运算符。当对Metrics API端点执行日期细分查询时，您会在响应中获得所选字段上计算值的列表（基于所选运算符），在所选时间间隔内，由另一个字段聚合。

  1. 统计
  • 订单统计
  • 购物车统计信息
  • r图恩斯统计*

统计数据是对从所选资源的特定字段中提取的值进行的数值计算（基于特定运算符）。在Metrics API端点上执行统计查询时，您会在响应中获得所选字段上的计算值（基于所选运算符）。

  1. 搜索
  • 订单搜索
  • 购物车搜索
  • 返回搜索

搜索是一种与其他查询（细分、日期细分和统计数据）略有不同的查询类型。搜索不是聚合，也不涉及任何基于运算符的计算，而是实际的搜索。在Metrics API端点上执行搜索查询时，您会在响应中得到与查询匹配的实际记录的请求字段列表（已排序、已过滤和已分页）。

用例

Commerce Layer Metrics API允许您从组织中提取和聚合相关的度量数据。将3种可用资源（订单、退货和购物车）上的4种可用查询类型（细分、日期细分、统计和搜索）结合起来，并添加适当的过滤器，可以覆盖适合您业务需求的广泛用例。

以下是涵盖商业层度量API最常见应用场景的工具列表：

  • 按市场划分的畅销产品 为您的组织的每个市场获得前N名最畅销的产品
  • 购买特定产品的客户 获取购买特定产品或捆绑包的客户总数
  • 经常一起购买的产品 将最常与其他产品一起购买的产品
  • 来自特定市场的具有特定产品的最新卡 从特定市场获取包含特定SKU的最新创建的购物车
  • 最新存档订单 获取最近存档的订单
  • 来自具有特定电子邮件域的客户的最新订单 在汇总的详细信息中获取包含特定电子邮件域的最后下订单
  • 按国家/地区列出的每份订单的产品数量 获取组织订单中包含的SKU数量的混合统计数据，按不同国家分组
  • 与特定业务相关的订单 获取触发特定促销的订单总数
  • 捆绑订单 获取包含捆绑包的订单总数，按捆绑包名称分组
  • 按货币排序的订单 获取组织的订单总数，按不同货币分组
  • 按日订购 按天分组，获取组织的订单总数
  • 回头客订单 按多次从您那里购买的客户分组，获取您组织的订单总数
  • 按资源错误代码和消息排序 检查与组织订单相关的错误（如果有的话）
  • 按装运状态和装运方式名称排序的订单 获取组织的订单总数，按关联的发货状态和相关的发货方式名称分组
  • 按状态和付款状态排列的订单 获取组织的订单总数，按订单状态和相关付款状态分组
  • 用礼品卡支付的订单 获取使用礼品卡支付的订单总数
  • 按国家和货币分列的退款 按不同国家和货币分组，获取贵组织的退款总数
  • 按目的地城市分列的每年回报率 按年份和目的地城市分组，获取订单要求的退货总数
  • 装运平均拣选时间 获取您的货物在包装前处于拣选状态的平均时间
  • 按货币分列的前10名支出者 找出你的客户中花钱最多的人，知道他们的总购买金额是如何除以货币的

分析

所有可用的Commerce Layer Metrics API助手端点。

  • 艏压载舱 FBT也称为Frequently Bught Together，是一种分析查询，它基于您的整个订单历史，允许您检索与指定商品（SKU或捆绑商品）或商品数组在同一订单中最常添加为行商品的商品。

参考文献

相关 MCP