tanush-yadav

@tanush-yadav/shopify-mcp

0 Stars 284 次浏览 tanush-yadav 更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "shopify": {
      "args": [
        "path/to/shopify-mcp-server/dist/index.js"
      ],
      "command": "node",
      "env": {
        "MYSHOPIFY_DOMAIN": "your-store.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "your_access_token"
      }
    }
  }
}

服务介绍

Shopify MCP 服务器

Shopify API 的 MCP 服务器，通过 GraphQL 与商店数据（产品、客户、订单等）进行交互。

功能

提供产品、客户和订单管理工具，直接的 GraphQL 集成以及清晰的错误处理。

前提条件

Node.js (v16+)
Shopify 自定义应用访问令牌

安装

bash
git clone https://github.com/pashpashpash/shopify-mcp-server.git
cd shopify-mcp-server
npm install
npm run build

Shopify 设置与配置

创建自定义应用：在 Shopify 管理后台 > 设置 > 应用和销售渠道 > 开发应用 > 创建一个应用。
配置权限范围：为 products、customers 和 orders 授予 read/write 权限。
安装应用并获取令牌：安装该应用并复制 Admin API 访问令牌。
在项目根目录中创建 .env 文件：

SHOPIFY_ACCESS_TOKEN=your_access_token
MYSHOPIFY_DOMAIN=your-store.myshopify.com
配置 Claude 桌面版 (claude_desktop_config.json)：
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%/Claude/claude_desktop_config.json
  json
  {
  "mcpServers": {
  "shopify": {
  "command": "node",
  "args": ["path/to/shopify-mcp-server/dist/index.js"],
  "env": {
  "SHOPIFY_ACCESS_TOKEN": "your_access_token",
  "MYSHOPIFY_DOMAIN": "your-store.myshopify.com"
  }
  }
  }
  }
注意：请使用克隆仓库的正确路径，并安全地存储您的令牌。

可用工具

产品管理

findProducts：获取所有产品或按标题搜索。
- searchTitle (可选字符串)：按标题过滤。
- limit (数字)：最大产品数量。
listProductsInCollection：从集合中获取产品。
- collectionId (字符串)：集合 ID。
- limit (可选数字，默认值：10)：最大产品数量。
getProductsByIds：按 ID 获取产品。
- productIds (字符串数组)：产品 ID。
getVariantsByIds：按 ID 获取变体。
- variantIds (字符串数组)：变体 ID。

客户管理

listCustomers：分页获取客户。
- limit (可选数字)：最大客户数量。
- next (可选字符串)：下一页游标。
addCustomerTags：为客户添加标签。
- customerId (字符串)：客户 ID。
- tags (字符串数组)：要添加的标签。

订单管理

findOrders：带有高级过滤/排序功能的获取订单。
- first (可选数字)：限制订单数量。
- after (可选字符串)：下一页游标。
- query (可选字符串)：过滤查询。
- sortKey (可选枚举)：排序字段。
- reverse (可选布尔值)：反向排序。
getOrderById：按 ID 获取单个订单。
- orderId (字符串)：订单 ID。
createDraftOrder：创建草稿订单。
- lineItems (数组)：商品（变体 ID，数量）。
- email (字符串)：客户电子邮件。
- shippingAddress (对象)：发货详情。
- note (可选字符串)：订单备注。
completeDraftOrder：完成草稿订单。
- draftOrderId (字符串)：草稿订单 ID。
- variantId (字符串)：变体 ID。

折扣管理

createDiscountCode：创建基本折扣码。
- title (字符串)：折扣标题。
- code (字符串)：折扣码。
- valueType (枚举)：百分比或固定金额。
- value (数字)：折扣值。
- startsAt (字符串)：开始日期（ISO 格式）。
- endsAt (可选字符串)：结束日期（ISO 格式）。
- appliesOncePerCustomer (布尔值)：每个客户仅限使用一次。

集合管理

listCollections：获取所有集合。
- limit (可选数字，默认值：10)：最大集合数量。
- name (可选字符串)：按名称过滤。

商店信息13. `getShopDetails`: 获取店铺基本信息（无需输入）。

getExtendedShopDetails: 获取扩展的店铺详细信息（无需输入）。

Webhook 管理

manageWebhooks: 管理 webhooks。
- action (枚举): subscribe , find , unsubscribe 。
- callbackUrl (字符串): Webhook URL。
- topic (枚举): Webhook 主题。
- webhookId (可选字符串): 取消订阅时必需。

调试工具

debugGetVariantMetafield: 获取变体及 size_chart_json 元字段。
- variantId (字符串): 变体 GID。

开发者工具

introspect_admin_schema: 检查 Admin API GraphQL 模式。
- query (字符串): 过滤条件。
- filter (可选数组): 按 types , queries , mutations , all 进行过滤。
search_dev_docs: 搜索 shopify.dev 文档。
- prompt (字符串): 搜索查询。

调试

检查 Claude Desktop MCP 日志：
bash
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

常见问题：

认证: 检查令牌、域名格式、API 权限范围。
API 错误: 检查速率限制、输入格式、必填字段。

开发

bash
npm install
npm run build
npm test

依赖项

@modelcontextprotocol/sdk
graphql-request
zod

许可证

MIT

注：原始 shopify-mcp-server 仓库的分支。

查看源码项目主页