Shopify MCP 服务器

适用于 Shopify API 的 MCP 服务器，支持通过 GraphQL API 与商店数据交互。该服务器提供用于管理产品、客户、订单等的工具。

特征

• 产品管理：搜索和检索产品信息

• 客户管理：加载客户数据并管理客户标签

• 订单管理：高级订单查询和过滤

• 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. update-product-price

   • 更新产品ID对应的产品价格

   • 输入：

     • productId （字符串）：要更新的产品的 ID

     • price （字符串）：产品的新价格

   • 返回：更新的响应

5. get-variants-by-ids

   • 通过 ID 获取产品变体

   • 输入：

     • variantIds （字符串数组）：要检索的变体 ID 数组

   • 返回：详细的变体信息，包括产品详细信息

6. get-customers

   • 通过分页支持获取 Shopify 客户

   • 输入：

     • limit （可选数字）：返回的最大客户数量

     • next （可选字符串）：下一页光标

   • 返回：JSON格式的客户数据

7. tag-customer

   • 为客户添加标签

   • 输入：

     • customerId （字符串）：要标记的客户 ID

     • tags （字符串数组）：要添加到客户的标签

   • 返回：成功或失败消息

8. get-orders

   • 通过高级筛选和排序获取订单

   • 输入：

     • first （可选数字）：退货订单数量

     • after （可选字符串）：下一页光标

     • query （可选字符串）：使用查询语法过滤订单

     • sortKey （可选枚举）：排序字段（'PROCESSED_AT'、'TOTAL_PRICE'、'ID'、'CREATED_AT'、'UPDATED_AT'、'ORDER_NUMBER'）

     • reverse （可选布尔值）：反转排序顺序

   • 返回：格式化的订单详情

9. get-order

   • 根据ID获取单个订单

   • 输入：

     • orderId （字符串）：要检索的订单的 ID

   • 返回：详细订单信息

10. create-discount

• 创建基本折扣代码

• 输入：

  • title （字符串）：折扣标题

  • code （字符串）：客户将输入的折扣代码

  • valueType （枚举）：折扣类型（“百分比”或“固定金额”）

  • value （数字）：折扣值（小数或固定金额的百分比）

  • startsAt （字符串）：ISO 格式的开始日期

  • endsAt （可选字符串）：ISO 格式的可选结束日期

  • appliesOncePerCustomer （布尔值）：每个客户是否只能使用一次折扣

• 返回：创建折扣详情

11. create-draft-order

• 创建草稿订单

• 输入：

  • lineItems （数组）：具有 variantId 和数量的项目数组

  • email （字符串）：客户电子邮件

  • shippingAddress （对象）：送货地址详情

  • note （可选字符串）：订单的可选注释

• 返回：创建草稿订单详情

12. complete-draft-order

• 完成草稿订单

• 输入：

  • draftOrderId (string)：待完成的草稿订单的 ID

  • variantId （字符串）：草稿订单中变体的 ID

• 返回：已完成的订单详情

13. get-collections

• 获取所有集合

• 输入：

  • limit （可选数字，默认值：10）：返回的最大集合数

  • name （可选字符串）：按名称过滤集合

• 返回：收集详情

14. get-shop

• 获取店铺详情

• 输入：无

• 返回：基本店铺信息

15. get-shop-details

• 获取包括运输国家在内的详细商店详情

• 输入：无

• 退货：扩展商店信息，包括运输国家

16. manage-webhook

• 订阅、查找或取消订阅 webhook

• 输入：

  • action （枚举）：要执行的操作（'订阅'，'查找'，'取消订阅'）

  • callbackUrl (字符串): Webhook 回调 URL

  • topic （枚举）：要订阅的 Webhook 主题

  • webhookId （可选字符串）：Webhook ID（取消订阅时必需）

• 返回：Webhook 详细信息或成功消息

设置

Shopify 访问令牌

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

1. 在 Shopify 管理员中，转到**“设置”** > “应用和销售渠道”

2. 单击**“开发应用程序”** （您可能需要先启用开发人员预览）

3. 单击**“创建应用程序”**

4. 为您的应用设置名称（例如“Shopify MCP Server”）

5. 点击配置管理 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 ：

发展

1. 克隆存储库

2. 安装依赖项：

3. 创建.env文件：

4. 构建项目：

5. 运行测试：

依赖项

• @modelcontextprotocol/sdk - MCP 协议实现

• graphql-request - Shopify API 的 GraphQL 客户端

• zod - 运行时类型验证

贡献

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

执照

麻省理工学院

社区

• MCP GitHub 讨论

• 报告问题

使用模型上下文协议用❤️构建