Shopify MCP Server

Shopify MCP Server

site icon
2025.02.17 1
TypeScript电子商务Shopify APIGraphQL金融服务
Shopify MCP Server 是一个用于与 Shopify API 交互的服务器,通过 GraphQL API 实现与商店数据的交互。该服务器提供了管理产品、客户、订单等多种工具,适用于电子商务平台的开发和管理。
View on GitHub

Overview

基本能力

产品定位

Shopify MCP Server 是一个用于与 Shopify API 交互的服务器,通过 GraphQL API 实现与商店数据的交互。该服务器提供了管理产品、客户、订单等多种工具,适用于电子商务平台的开发和管理。

核心功能

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

适用场景

  • 电子商务平台的开发和管理
  • 产品、客户和订单的自动化管理
  • 与 Shopify 商店的数据交互

工具列表

  1. get-products:获取所有产品或按标题搜索
  2. get-products-by-collection:从特定集合获取产品
  3. get-products-by-ids:按 ID 获取产品
  4. get-variants-by-ids:按 ID 获取产品变体
  5. get-customers:获取 Shopify 客户,支持分页
  6. tag-customer:为客户添加标签
  7. get-orders:获取订单,支持高级过滤和排序
  8. get-order:按 ID 获取单个订单
  9. create-discount:创建基本折扣代码
  10. create-draft-order:创建草稿订单
  11. complete-draft-order:完成草稿订单
  12. get-collections:获取所有集合
  13. get-shop:获取商店详情
  14. get-shop-details:获取扩展商店详情,包括运输国家
  15. manage-webhook:订阅、查找或取消订阅 webhooks

常见问题解答

  • 如何获取 Shopify 访问令牌?:需要在 Shopify 商店中创建自定义应用,并配置适当的 API 范围。
  • 如何配置 MCP 服务器?:需要在 claude_desktop_config.json 文件中添加相应的配置。

使用教程

使用依赖

  1. 确保已安装 Node.js 和 npm
  2. 安装项目依赖:
npm install

安装教程

  1. 克隆仓库
  2. 创建 .env 文件并配置 Shopify 访问令牌和商店域名:
SHOPIFY_ACCESS_TOKEN=your_access_token
MYSHOPIFY_DOMAIN=your-store.myshopify.com
  1. 构建项目:
npm run build

调试方式

  1. 运行测试:
npm test
  1. 确保所有测试通过,检查日志以确认服务器正常运行。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。