Shopify MCP Server 使用说明

项目简介

Shopify MCP Server 是一个 MCP 服务器实现，它通过 Model Context Protocol (MCP) 协议与 LLM 客户端通信，提供了一系列工具，使用户能够方便地访问和操作 Shopify 商店的数据。该服务器集成了 Shopify GraphQL Admin API 和 REST Admin API，提供了全面的 Shopify 数据管理能力。

主要功能点

产品管理：检索商品信息、按集合ID或商品ID获取商品、更新商品价格等。
订单管理：查询和筛选订单、获取单个订单的详细信息。
客户管理：分页获取客户数据、为客户添加标签。
折扣管理：创建基础折扣码和草稿订单。
集合管理：获取商品集合信息。
店铺信息：获取店铺基本信息和详细信息，包括支持的发货国家/地区。
Webhook 管理：订阅、查找和取消订阅 Webhook，以监控店铺事件。

安装步骤

克隆仓库

git clone https://github.com/therealhexi/shopify-mcp-server-main.git
cd shopify-mcp-server-main

安装依赖
```
npm install
```
配置环境变量
- 在项目根目录下创建 '.env' 文件。
- 在 '.env' 文件中填写您的 Shopify Access Token 和店铺域名，例如：
```
SHOPIFY_ACCESS_TOKEN=YOUR_ACCESS_TOKEN
MYSHOPIFY_DOMAIN=YOUR_SHOP.myshopify.com
```
  注意：
  - 'SHOPIFY_ACCESS_TOKEN' 需要您在 Shopify 后台创建自定义应用并安装后获取。请参考 README.md 中的 "Setup" 部分获取详细步骤。
  - 'MYSHOPIFY_DOMAIN' 是您的 Shopify 店铺域名，例如 'your-store.myshopify.com'。
构建项目
```
npm run build
```

服务器配置

要将 Shopify MCP Server 集成到 MCP 客户端（例如 Claude Desktop），您需要在客户端的配置文件中添加以下服务器配置信息。以 'claude_desktop_config.json' 为例：

{
  "mcpServers": {
    "shopify": {  // 服务器名称，可以自定义
      "command": "npx", // 启动命令，npx 用于执行本地 node_modules 中的包
      "args": ["-y", "shopify-mcp-server"], // 启动参数，-y 表示自动确认安装包， shopify-mcp-server 是 package.json 中 bin 字段配置的可执行文件名
      "env": { // 环境变量配置
        "SHOPIFY_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>", // 您的 Shopify Admin API 访问令牌，请替换为实际值
        "MYSHOPIFY_DOMAIN": "<YOUR_SHOP>.myshopify.com"  // 您的 Shopify 店铺域名，请替换为实际值
      }
    }
  }
}

基本使用方法

配置完成后，MCP 客户端将能够连接到 Shopify MCP Server。您可以通过客户端的界面或指令来调用服务器提供的工具，例如：

使用 'get-products' 工具检索商品信息。
使用 'get-orders' 工具查询订单。
使用 'tag-customer' 工具为客户添加标签。

具体工具的使用方法和参数，请参考 README.md 文件中 "Tools" 部分的详细描述。

关键词