S

Shopify MCP 服务管理工具

@rezapex/shopify-mcp-server-main
Hosted
0 Stars 445 次浏览 rezapex 更新于 2026-08-23

通过 GraphQL API 启用与 Shopify 商店数据的交互,提供管理产品、客户、订单、折扣等的工具,并具备强大的错误处理功能。

MCP 服务配置

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

{
  "mcpServers": {
    "shopify": {
      "args": [
        "-y",
        "shopify-mcp-server"
      ],
      "command": "npx",
      "env": {
        "MYSHOPIFY_DOMAIN": "\u003cSHOP\u003e.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "\u003cTOKEN\u003e"
      }
    }
  }
}

该服务需要配置环境变量:MYSHOPIFY_DOMAIN、SHOPIFY_ACCESS_TOKEN

可用工具 (15 个)

该服务在 MCP 协议中暴露的工具,AI 可按需调用

get-products 2 个参数 需填 1 项

Get all products or search by title

必填参数:limit

get-products-by-collection 2 个参数 需填 1 项

Get products from a specific collection

必填参数:collectionId

get-products-by-ids 1 个参数 需填 1 项

Get products by their IDs

必填参数:productIds

get-variants-by-ids 1 个参数 需填 1 项

Get product variants by their IDs

必填参数:variantIds

get-customers 2 个参数

Get shopify customers with pagination support

该工具无需必填参数,直接调用即可

tag-customer 2 个参数 需填 2 项

Add tags to a customer

必填参数:customerId、tags

get-orders 5 个参数

Get shopify orders with advanced filtering and sorting

该工具无需必填参数,直接调用即可

get-order 1 个参数 需填 1 项

Get a single order by ID

必填参数:orderId

create-discount 7 个参数 需填 6 项

Create a basic discount code

必填参数:title、code、valueType、value、startsAt、appliesOncePerCustomer

create-draft-order 4 个参数 需填 3 项

Create a draft order

必填参数:lineItems、email、shippingAddress

complete-draft-order 2 个参数 需填 2 项

Complete a draft order

必填参数:draftOrderId、variantId

get-collections 2 个参数

Get all collections

该工具无需必填参数,直接调用即可

get-shop

Get shop details

该工具无需必填参数,直接调用即可

get-shop-details

Get extended shop details including shipping countries

该工具无需必填参数,直接调用即可

manage-webhook 4 个参数 需填 3 项

Subscribe, find, or unsubscribe webhooks

必填参数:action、callbackUrl、topic

服务介绍

🚀 概述

Shopify MCP 服务器通过模型上下文协议在您的应用程序和 Shopify 生态系统之间提供了一个强大的桥梁。通过简单的 API 调用轻松管理产品、客户、订单等。

📋 目录

📥 安装

选择您喜欢的安装方法:

方法 说明
Smithery smithery 徽章
Glama.ai glama.ai 徽章
NPM npm install shopify-mcp-server

✨ 功能

  • 🛍️ 全面的产品管理 - 搜索、检索和管理产品数据
  • 👥 客户数据访问 - 获取客户信息并管理标签
  • 📦 高级订单处理 - 轻松过滤、排序和管理订单
  • ⚡ 直接 GraphQL 集成 - 直接连接到 Shopify 的管理 API
  • 🛡️ 强大的错误处理 - 清晰的故障排除反馈

🧰 可用工具

产品管理

工具 描述 关键参数
get-products 按标题查找产品 searchTitle, limit
get-products-by-collection 获取集合中的产品 collectionId, limit
get-products-by-ids 检索特定产品 productIds
get-variants-by-ids 获取变体详情 variantIds

客户管理

工具 描述 关键参数
get-customers 检索客户数据 limit, next
tag-customer 为客户添加标签 customerId, tags

订单管理

工具 描述 关键参数
get-orders 过滤和排序订单 first, after, query, sortKey
get-order 获取单个订单详情 orderId

商店与集合工具

工具 描述 关键参数
get-collections 检索商店集合 limit, name
get-shop 获取基本商店详情
get-shop-details 获取扩展的商店信息

折扣管理

工具 描述 关键参数
create-discount 创建折扣码 title, code, valueType, value

🏁 开始使用

  1. 安装包

    npm install shopify-mcp-server
    
  2. 设置环境变量

    SHOPIFY_ACCESS_TOKEN=your_token
    MYSHOPIFY_DOMAIN=your-store.myshopify.com
    
  3. 初始化服务器

    require('shopify-mcp-server').start();
    
  4. 进行您的第一个API调用

    const products = await shopifyMcpServer.tools.getProducts({ limit: 10 });
    console.log(products);
    

💡 使用场景

  • 电子商务平台集成 - 在系统之间同步产品和订单
  • 自定义管理仪表板 - 构建符合您业务需求的界面
  • 订单自动化 - 设置工作流程以实现自动订单处理
  • 多渠道销售管理 - 管理所有销售渠道的库存

🔧 设置指南

获取Shopify访问令牌

  1. 从您的Shopify管理员页面,转到 设置 > 应用程序和销售渠道
  2. 点击 开发应用 > 创建一个应用
  3. 命名您的应用(例如:“Shopify MCP Server”)
  4. 配置API权限范围:
    • read_products, write_products
    • read_customers, write_customers
    • read_orders, write_orders
  5. 点击 保存安装应用
  6. 复制您的 Admin API访问令牌

安全提示: 安全地存储您的访问令牌。切勿将其提交到版本控制系统。

与Claude桌面版一起使用

在您的 claude_desktop_config.json 中添加:

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": ["-y", "shopify-mcp-server"],
      "env": {
        "SHOPIFY_ACCESS_TOKEN": "<TOKEN>",
        "MYSHOPIFY_DOMAIN": "<SHOP>.myshopify.com"
      }
    }
  }
}

👨‍💻 开发

# Clone the repository
git clone https://github.com/your-username/shopify-mcp-server.git

# Install dependencies
cd shopify-mcp-server
npm install

# Set up environment variables
# Create a .env file with your Shopify credentials

# Build and test
npm run build
npm test

🤝 社区

资源 链接
GitHub讨论 加入对话
问题追踪器 报告错误
Twitter @rezajafar
Discord 加入我们的服务器

相关 MCP 服务