Magento 2 MCP 服务器
这是一个连接到 Magento 2 REST API 的模型上下文协议 (MCP) 服务器，允许 Claude 和其他 MCP 客户端从 Magento 商店查询产品信息。
特征
产品特性
通过SKU或ID查询产品信息
使用各种标准搜索产品
获取产品类别
获取相关产品
获取产品库存信息
获取产品属性
通过指定属性代码和值来更新产品属性
具有过滤和排序功能的高级产品搜索
客户特征
通过电子邮件地址获取客户订购的所有产品
订单和收入功能
获取特定日期范围内的订单数量
获取特定日期范围的收入
获取按国家/地区筛选的特定日期范围内的收入
获取产品销售统计数据，包括销售数量和最畅销产品
支持相对日期表达式，如“今天”、“昨天”、“上周”、“本月”、“年初至今”
支持使用国家代码和国家名称进行国家过滤
Related MCP server: API Tester MCP Server
先决条件
Node.js（v14 或更高版本）
具有 REST API 访问权限的 Magento 2 实例
Magento 2 实例的 API 令牌
安装
克隆此存储库
安装依赖项：
用法
直接运行服务器
使用测试客户端进行测试
与 Claude Desktop 一起使用
检查你的路径节点与
which node前往开发者设置，点击“编辑配置”。这将打开一个 JSON 文件。
在
mcpServers中添加以下代码片段：
将
/path/to/your/node替换为您在步骤 1 中检查的路径将
/path/to/mcp-server.js替换为您克隆此 repo 的路径您可以从 Magento 管理员的“系统”>“集成”获取 API 令牌
重新启动 Claude Desktop。
现在您应该可以向 Claude 询问有关 Magento 商店中的产品的问题。
可用工具
该服务器公开以下工具：
产品工具
get_product_by_sku：通过 SKU 获取产品的详细信息search_products：使用 Magento 搜索条件搜索产品get_product_categories：按 SKU 获取特定产品的类别get_related_products：按 SKU 获取与特定产品相关的产品get_product_stock：按 SKU 获取产品的库存信息get_product_attributes：按 SKU 获取产品的所有属性get_product_by_id：通过产品 ID 获取产品的详细信息advanced_product_search：使用高级过滤选项搜索产品update_product_attribute：按 SKU 更新产品的特定属性
客户工具
get_customer_ordered_products_by_email：通过电子邮件地址获取客户订购的所有产品
订单和收入工具
get_order_count：获取给定日期范围内的订单数量get_revenue：获取给定日期范围内的总收入get_revenue_by_country：获取给定日期范围内按国家/地区过滤的收入get_product_sales：获取给定日期范围内销售产品数量的统计信息
Claude 的示例查询
一旦 MCP 服务器连接到 Claude Desktop，您就可以提出以下问题：
产品查询
“你们有哪些衬衫产品？”
“告诉我有关 SKU 为 SKU-xxx 的产品的信息”
“产品SKU-xxx属于哪些类别？”
“是否有与SKU-SKU-xxx相关的产品？”
“产品SKU-xxx的库存状况如何？”
“显示按价格排序的所有产品”
“将产品 SKU-xxx 的价格更新为 49.99 美元”
“将产品 ABC-123 的描述更改为防水”
“将产品 XYZ-456 的状态设置为‘已启用’”
客户查询
“客户john.doe@example.com订购了哪些产品？”
“显示电子邮件为jane.smith@example.com 的客户的订单历史记录和产品”
订单和收入查询
“我们今天有多少订单？”
“我们上周的订单数量是多少？”
“我们昨天创造了多少收入？”
“我们上个月的总收入是多少？”
“今年到目前为止我们在荷兰的收入是多少？”
“我们上周在德国的收入是多少？”
“比较一下本月我们在美国和加拿大的收入”
“我们本月已完成订单的平均订单价值是多少？”
“我们上个月销售了多少产品？”
“我们今年最畅销的产品是什么？”
“每份订单的平均产品数量是多少？”
“上个季度我们在德国销售了多少单位产品 XYZ-123？”
“本月哪些产品在美国创造了最多的收入？”
发展
SSL证书验证
出于开发目的，服务器已配置为绕过 SSL 证书验证。在生产环境中，您应该使用正确的 SSL 证书，并从callMagentoApi函数中移除httpsAgent配置。
添加新工具
要添加新工具，请遵循现有代码中的模式。每个工具的定义如下：
独特的名字
描述
使用 Zod 进行验证的输入参数
处理请求并返回响应的异步处理函数
执照
国际学习中心