Shopify MCP 服务器

(如果喜欢请点个星!)

Shopify API 的 MCP 服务器，通过 GraphQL API 实现商店数据交互。该服务器提供了管理商品、客户、订单等功能的工具。

功能

• 商品管理：搜索和获取商品信息
• 客户管理：加载客户数据并管理客户标签
• 订单管理：具有高级查询和筛选功能
• GraphQL 集成：直接集成 Shopify 的 GraphQL 管理 API
• 全面错误处理：清晰的错误消息，针对 API 和身份验证问题

先决条件

1. Node.js (版本 16 或更高)
2. Shopify 自定义应用访问令牌（参见下面的设置）

设置

创建自定义应用获取访问令牌

要使用此 MCP 服务器，您需要在 Shopify 后台创建一个自定义应用并获取访问令牌。

步骤如下：

1. 登录到您的 Shopify 管理员面板。
2. 导航至 应用程序 > 自定义应用。
3. 点击 新建应用。
4. 填写应用信息，包括名称和回调 URL（例如 http://localhost:8080）。
5. 保存应用后，进入应用详情页面获取 访问令牌。

将此访问令牌用于配置 MCP 服务器时需要的凭据。

使用 Claude Desktop 配置

在 Claude Desktop 中使用以下 JSON 配置：

{
  "name": "Shopify MCP Server",
  "type": "process",
  "command": "npx",
  "args": [
    "shopify-mcp-server",
    "--apiKey",
    "<您的 API 密钥>",
    "--apiSecretKey",
    "<您的 API 秘钥>",
    "--host",
    "localhost",
    "--port",
    "8080"
  ],
  "stdout": {
    "filePath": "/var/log/claude/shopify-mcp-server.stdout.log",
    "maxSize": 1024,
    "numFiles": 3
  },
  "stderr": {
    "filePath": "/var/log/claude/shopify-mcp-server.stderr.log",
    "maxSize": 1024,
    "numFiles": 3
  }
}

将 <您的 API 密钥> 和 <您的 API 秘钥> 替换为您实际的 Shopify 应用凭据。

使用环境变量

您也可以通过设置以下环境变量来配置 MCP 服务器：

• SHOPFY_API_KEY：API 访问令牌
• SHOPFY_API_SECRET_KEY：API 密钥
• MCP_HOST：默认为 localhost
• MCP_PORT：默认为 8080

直接安装

如果需要，您可以直接安装此服务器：

npm install -g shopify-mcp-server

然后运行它：

shopify-mcp-server --apiKey=<您的 API 密钥> --apiSecretKey=<您的 API 秘钥>

可用工具

商品管理

1. get-products：获取商品列表

   {
     "status": "active" // 可选：筛选状态，默认返回所有商品
   }
   

2. get-product-by-id：通过 ID 获取单个商品

3. update-product：更新商品信息

客户管理

1. get-customers：获取客户列表

2. get-customer-by-id：通过 ID 获取客户详细信息

3. create-customer：创建新客户

   {
     "email": "test@example.com",
     "first_name": "John",
     "last_name": "Doe"
   }
   

4. update-customer：更新客户信息

5. delete-customer：删除客户

订单管理

1. get-orders：获取订单列表

2. get-order-by-id：通过 ID 获取订单详细信息

3. create-order：创建新订单

4. update-order：更新订单信息

调试

如需调试，请检查 Claude Desktop 的 MCP 日志：

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

许可证

MIT