Shopify MCP 服务器

用于 Shopify API 的 MCP 服务器，可以通过 GraphQL API 与商店数据进行交互。此服务器提供用于管理产品、客户、订单等的工具。

<a href="https://glama.ai/mcp/servers/bemvhpy885"><img width="380" height="200" src="https://glama.ai/mcp/servers/bemvhpy885/badge" alt="Shopify Server MCP server" /></a>

功能

• 产品管理: 搜索和检索产品信息
• 客户管理: 加载客户数据和管理客户标签
• 订单管理: 高级订单查询和过滤
• GraphQL 集成: 与 Shopify 的 GraphQL Admin API 直接集成
• 全面的错误处理: 针对 API 和身份验证问题的清晰错误消息

工具

1. get-products

   • 获取所有产品或按标题搜索
   • 输入:
     • searchTitle (可选字符串): 按标题过滤产品
     • limit (数字): 要返回的最大产品数量
   • 返回: 格式化的产品详细信息，包括标题、描述、句柄和变体

2. get-products-by-collection

   • 从特定集合中获取产品
   • 输入:
     • collectionId (字符串): 要从中获取产品的集合的 ID
     • limit (可选数字, 默认: 10): 要返回的最大产品数量
   • 返回: 来自指定集合的格式化产品详细信息

3. get-products-by-ids

   • 通过 ID 获取产品
   • 输入:
     • productIds (字符串数组): 要检索的产品 ID 数组
   • 返回: 指定产品的格式化产品详细信息

4. get-variants-by-ids

   • 通过 ID 获取产品变体
   • 输入:
     • variantIds (字符串数组): 要检索的变体 ID 数组
   • 返回: 详细的变体信息，包括产品详细信息

5. get-customers

   • 获取支持分页的 Shopify 客户
   • 输入:
     • limit (可选数字): 要返回的最大客户数量
     • next (可选字符串): 下一页游标
   • 返回: JSON 格式的客户数据

6. tag-customer

   • 向客户添加标签
   • 输入:
     • customerId (字符串): 要标记的客户 ID
     • tags (字符串数组): 要添加到客户的标签
   • 返回: 成功或失败消息

7. get-orders

   • 获取具有高级过滤和排序的订单
   • 输入:
     • first (可选数字): 要返回的订单限制
     • after (可选字符串): 下一页游标
     • query (可选字符串): 使用查询语法过滤订单
     • sortKey (可选枚举): 要排序的字段 ('PROCESSED_AT', 'TOTAL_PRICE', 'ID', 'CREATED_AT', 'UPDATED_AT', 'ORDER_NUMBER')
     • reverse (可选布尔值): 反转排序顺序
   • 返回: 格式化的订单详细信息

8. get-order

   • 通过 ID 获取单个订单
   • 输入:
     • orderId (字符串): 要检索的订单 ID
   • 返回: 详细的订单信息

9. create-discount

   • 创建基本折扣码
   • 输入:
     • title (字符串): 折扣标题
     • code (字符串): 客户将输入的折扣码
     • valueType (枚举): 折扣类型 ('percentage' 或 'fixed_amount')
     • value (数字): 折扣值（百分比为小数或固定金额）
     • startsAt (字符串): ISO 格式的开始日期
     • endsAt (可选字符串): ISO 格式的可选结束日期
     • appliesOncePerCustomer (布尔值): 折扣是否只能每个客户使用一次
   • 返回: 创建的折扣详细信息

10. create-draft-order

    • 创建草稿订单
    • 输入:
      • lineItems (数组): 包含 variantId 和 quantity 的商品数组
      • email (字符串): 客户电子邮件
      • shippingAddress (对象): 运送地址详细信息
      • note (可选字符串): 订单的可选备注
    • 返回: 创建的草稿订单详细信息

11. complete-draft-order

    • 完成草稿订单
    • 输入:
      • draftOrderId (字符串): 要完成的草稿订单的 ID
      • variantId (字符串): 草稿订单中的变体 ID
    • 返回: 已完成的订单详细信息

12. get-collections

    • 获取所有集合
    • 输入:
      • limit (可选数字, 默认: 10): 要返回的最大集合数量
      • name (可选字符串): 按名称过滤集合
    • 返回: 集合详细信息

13. get-shop

    • 获取商店详细信息
    • 输入: 无
    • 返回: 基本商店信息

14. get-shop-details

    • 获取扩展的商店详细信息，包括运送国家/地区
    • 输入: 无
    • 返回: 扩展的商店信息，包括运送国家/地区

15. manage-webhook

    • 订阅、查找或取消订阅 Webhook
    • 输入:
      • action (枚举): 要执行的操作 ('subscribe', 'find', 'unsubscribe')
      • callbackUrl (字符串): Webhook 回调 URL
      • topic (枚举): 要订阅的 Webhook 主题
      • webhookId (可选字符串): Webhook ID（取消订阅时必需）
    • 返回: Webhook 详细信息或成功消息

设置

Shopify 访问令牌

要使用此 MCP 服务器，您需要在 Shopify 商店中创建一个自定义应用：

1. 在 Shopify 管理后台中，转到设置 > 应用和销售渠道
2. 点击开发应用（您可能需要先启用开发者预览）
3. 点击创建应用
4. 为您的应用设置一个名称（例如，“Shopify MCP Server”）
5. 点击配置 Admin API 作用域
6. 选择以下作用域：
   • read_products, write_products
   • read_customers, write_customers
   • read_orders, write_orders
7. 点击保存
8. 点击安装应用
9. 点击安装以授予应用访问您的商店数据的权限
10. 安装后，您将看到您的 Admin API 访问令牌
11. 复制此令牌 - 您将需要它进行配置

注意：安全地存储您的访问令牌。它提供对您的商店数据的访问权限，绝不应共享或提交到版本控制。 有关如何创建 Shopify 应用的更多详细信息，请参见此处。

与 Claude Desktop 一起使用

添加到您的 claude_desktop_config.json：

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

开发

1. 克隆存储库
2. 安装依赖项：

npm install

3. 创建一个 .env 文件：

SHOPIFY_ACCESS_TOKEN=your_access_token
MYSHOPIFY_DOMAIN=your-store.myshopify.com

4. 构建项目：

npm run build

5. 运行测试：

npm test

依赖项

• @modelcontextprotocol/sdk - MCP 协议实现
• graphql-request - 用于 Shopify API 的 GraphQL 客户端
• zod - 运行时类型验证

贡献

欢迎贡献！请先阅读我们的贡献指南。

许可证

MIT

社区

• MCP GitHub Discussions
• 报告问题

---

使用 Model Context Protocol 构建，充满 ❤️