商务层度量MCP服务器
此存储库提供了一个本地MCP服务器实现，其中包含一套用于商务层数据分析的度量工具。
______________________________________________________________________
目录
______________________________________________________________________
概述
Metrics Local MCP Server公开了一组与Commerce层交互的工具 指标API 并使您能够从组织的订单、退货或购物车历史中提取几乎任何类型的数据信息。
______________________________________________________________________
安装
来自GIT存储库
- 克隆存储库：
git clone https://github.com/your-org/mcp-server-metrics.git
cd mcp-server-metrics- 安装依赖项：
pnpm install- 构建项目：
pnpm build- 创建服务器：
pnpm dist编译后的文件将在 dist/ 目录，可用于在首选AI代理中设置MCP本地服务器(克劳德后退，OpenAI聊天GPT。..).
作为克劳德桌面扩展
Claude Dekstop现在可以轻松安装自定义MCP本地服务器，既可以作为预构建的捆绑包，也可以作为未打包的扩展包。 这里 您可以从Anthropic的支持人员那里找到执行安装的说明。
按照从GIT存储库安装的步骤进行操作，然后：
- 创建扩展包：
npm run mcpb- 安装扩展：
上传打包的扩展，从中获取捆绑包 mcpb/commercelayer-metrics.mcpb
根据要求插入 *客户端id* 和 *客户端密码* 连接到您的Commerce Layer组织。
______________________________________________________________________
工具
查询
这些工具允许您检索以下指标数据和统计数据 *订单*, *手推车* 和 *回报* 通过四种类型的查询：
- 故障
- *订单明细*
- *推车故障*
- *退货明细*
分解是将数据汇总为度量（基于特定运算符）或统计数据的聚合，这些度量或统计数据是根据字段值计算的。当对Metrics API端点执行细分查询时，您会在响应中获得所选字段上的计算值（基于所选运算符），并由另一个字段聚合。
- 日期细分
- *订单日期明细*
- *购物车日期细分*
- *退货日期明细*
日期细分是一种聚合，显示数据集中特定日期值的出现频率，并允许您在该日期存在的记录的选定字段上应用特定运算符。当对Metrics API端点执行日期细分查询时，您会在响应中获得所选字段上计算值的列表（基于所选运算符），在所选时间间隔内，由另一个字段聚合。
- 统计
- *订单统计*
- *购物车统计信息*
- *r*图恩斯统计\*
统计数据是对从所选资源的特定字段中提取的值进行的数值计算（基于特定运算符）。在Metrics API端点上执行统计查询时，您会在响应中获得所选字段上的计算值（基于所选运算符）。
- 搜索
- *订单搜索*
- *购物车搜索*
- *返回搜索*
搜索是一种与其他查询（细分、日期细分和统计数据）略有不同的查询类型。搜索不是聚合，也不涉及任何基于运算符的计算，而是实际的搜索。在Metrics API端点上执行搜索查询时，您会在响应中得到与查询匹配的实际记录的请求字段列表（已排序、已过滤和已分页）。
用例
Commerce Layer Metrics API允许您从组织中提取和聚合相关的度量数据。将3种可用资源（订单、退货和购物车）上的4种可用查询类型（细分、日期细分、统计和搜索）结合起来，并添加适当的过滤器，可以覆盖适合您业务需求的广泛用例。
以下是涵盖商业层度量API最常见应用场景的工具列表：
- *按市场划分的畅销产品*
为您的组织的每个市场获得前N名最畅销的产品
- *购买特定产品的客户*
获取购买特定产品或捆绑包的客户总数
- *经常一起购买的产品*
将最常与其他产品一起购买的产品
- *来自特定市场的具有特定产品的最新卡*
从特定市场获取包含特定SKU的最新创建的购物车
- *最新存档订单*
获取最近存档的订单
- *来自具有特定电子邮件域的客户的最新订单*
在汇总的详细信息中获取包含特定电子邮件域的最后下订单
- *按国家/地区列出的每份订单的产品数量*
获取组织订单中包含的SKU数量的混合统计数据，按不同国家分组
- *与特定业务相关的订单*
获取触发特定促销的订单总数
- *捆绑订单*
获取包含捆绑包的订单总数，按捆绑包名称分组
- *按货币排序的订单*
获取组织的订单总数，按不同货币分组
- *按日订购*
按天分组，获取组织的订单总数
- *回头客订单*
按多次从您那里购买的客户分组，获取您组织的订单总数
- *按资源错误代码和消息排序*
检查与组织订单相关的错误（如果有的话）
- *按装运状态和装运方式名称排序的订单*
获取组织的订单总数，按关联的发货状态和相关的发货方式名称分组
- *按状态和付款状态排列的订单*
获取组织的订单总数，按订单状态和相关付款状态分组
- *用礼品卡支付的订单*
获取使用礼品卡支付的订单总数
- *按国家和货币分列的退款*
按不同国家和货币分组，获取贵组织的退款总数
- *按目的地城市分列的每年回报率*
按年份和目的地城市分组，获取订单要求的退货总数
- *装运平均拣选时间*
获取您的货物在包装前处于拣选状态的平均时间
- *按货币分列的前10名支出者*
找出你的客户中花钱最多的人，知道他们的总购买金额是如何除以货币的
分析
所有可用的Commerce Layer Metrics API助手端点。
- *艏压载舱*
FBT也称为Frequently Bught Together，是一种分析查询，它基于您的整个订单历史，允许您检索与指定商品（SKU或捆绑商品）或商品数组在同一订单中最常添加为行商品的商品。
______________________________________________________________________