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. 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 （枚举）：折扣类型（“百分比”或“固定金额”）
     • value （数字）：折扣值（小数或固定金额的百分比）
     • startsAt （字符串）：ISO 格式的开始日期
     • endsAt （可选字符串）：ISO 格式的可选结束日期
     • appliesOncePerCustomer （布尔值）：每个客户是否只能使用一次折扣
   • 返回：创建折扣详情
10. create-draft-order

• 创建草稿订单
• 输入：
  • lineItems （数组）：具有 variantId 和数量的项目数组
  • email （字符串）：客户电子邮件
  • shippingAddress （对象）：送货地址详情
  • note （可选字符串）：订单的可选注释
• 返回：创建草稿订单详情

11. complete-draft-order

• 完成草稿订单
• 输入：
  • draftOrderId (string)：待完成的草稿订单的 ID
  • variantId （字符串）：草稿订单中变体的 ID
• 返回：已完成的订单详情

12. get-collections

• 获取所有集合
• 输入：
  • limit （可选数字，默认值：10）：返回的最大集合数
  • name （可选字符串）：按名称过滤集合
• 返回：收集详情

13. get-shop

• 获取店铺详情
• 输入：无
• 返回：基本店铺信息

14. get-shop-details

• 获取包括运输国家在内的详细商店详情
• 输入：无
• 退货：扩展商店信息，包括运输国家/地区

15. 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 讨论
• 报告问题

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