Magento 2 MCP 服务器

这是一个模型上下文协议（MCP）服务器，连接到 Magento 2 REST API，允许 Claude 和其他 MCP 客户查询 Magento 商店中的产品信息。

功能

产品功能

• 按 SKU 或 ID 查询产品信息
• 使用各种标准搜索产品
• 获取产品的类别
• 获取相关产品
• 获取产品的库存信息
• 获取产品属性
• 通过指定属性代码和值更新产品属性
• 带有筛选和排序的高级产品搜索

客户功能

• 按电子邮件地址获取客户的所有已购产品

订单与收入功能

• 查询特定日期范围内的订单数量
• 查询特定日期范围内的总收入
• 查询按国家过滤后的特定日期范围内的收入
• 获取产品的销售统计信息，包括售出数量和最畅销的产品
• 支持相对日期表达式（如“今天”、“昨天”、“上周”、“本月”、“年初至今”）
• 支持使用国家代码和国家名称进行国家过滤

先决条件

• Node.js (v14 或更高版本)
• 带有 REST API 访问权限的 Magento 2 实例
• Magento 2 实例的 API 密钥

安装

1. 克隆此仓库
2. 安装依赖项：

npm install

使用方法

直接运行服务器

node mcp-server.js

使用测试客户端进行测试

node test-mcp-server.js

与 Claude Desktop 配合使用

1. 检查您的 Node 路径：which node
2. 转到开发者设置并点击“编辑配置”。这将打开一个 JSON 文件。
3. 在 mcpServers 中添加以下代码片段：

    "magento2": {
      "command": "/path/to/your/node",
      "description": ""
    }

4. 将 /path/to/your/node 替换为实际的 Node.js 路径。

可用工具

• createMagentocommandTool：创建用于执行 Magento 命令的 CLI 工具。
• healthCheckMCP：对 MCP 服务器进行健康检查，确保其正常运行。
• productImportExport：实现产品的导入和导出功能。

示例查询

产品查询示例

curl -X POST http://localhost:3000/magento/product-import-export \
-H "Content-Type: application/json" \
-d '{"action": "import", "products": ["SKU123", "SKU456"]}'

订单统计示例

curl -X POST http://localhost:3000/magento/orders \
-H "Content-Type: application/json" \
-d '{"startDate": "2023-01-01", "endDate": "2023-12-31"}'

开发

SSL 证书验证

为了开发目的，服务器配置为绕过 SSL 证书验证。在生产环境中，请使用有效的 SSL 证书，并从 callMagentoApi 函数中移除 httpsAgent 配置。

添加新工具

要添加新的工具，请按照现有代码的模式进行。每个工具都定义为：

1. 唯一名称
2. 描述
3. 使用 Zod 进行输入参数验证
4. 异步处理函数，用于处理请求并返回响应

许可证

ISC