Shopify Admin GraphQL MCP Server

Shopify Admin GraphQL MCP Server

site icon
2025.04.02 0
JavaScriptShopify 管理GraphQL API电子商务金融服务
Shopify Admin GraphQL MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,用于与 Shopify 的 Admin GraphQL API 进行交互。该服务提供了管理产品、订单、客户、库存、折扣、元字段和店铺信息的工具和资源。
View on GitHub

Overview

基本能力

产品定位

Shopify Admin GraphQL MCP Server 是一个专门为 Shopify 商家提供的后端服务,用于通过 GraphQL API 管理其在线商店的各个方面。

核心功能

  • 完整的 Shopify Admin API 功能覆盖
  • 为所有主要 Shopify 资源提供的结构化工具
  • 每个 API 部分的文档资源
  • 易于与任何 MCP 兼容的客户端一起使用

适用场景

  • 管理 Shopify 商店的产品、订单、客户、库存、折扣和元字段
  • 获取和更新店铺信息
  • 自动化 Shopify 商店的后端管理任务

工具列表

Products

  • getProduct: 通过 ID 获取产品
  • listProducts: 分页列出产品
  • createProduct: 创建新产品
  • updateProduct: 更新现有产品
  • deleteProduct: 删除产品

Orders

  • getOrder: 通过 ID 获取订单
  • listOrders: 分页列出订单
  • cancelOrder: 取消订单

Customers

  • getCustomer: 通过 ID 获取客户
  • listCustomers: 分页列出客户
  • createCustomer: 创建新客户
  • updateCustomer: 更新现有客户
  • deleteCustomer: 删除客户

Inventory

  • getInventoryItem: 通过 ID 获取库存项
  • adjustInventory: 调整库存水平
  • getInventoryLevel: 获取位置和项的库存水平

Discounts

  • getDiscount: 通过 ID 获取折扣
  • createDiscount: 创建基本折扣代码
  • deleteDiscount: 删除折扣

Metafields

  • getMetafield: 通过 ID 获取元字段
  • createProductMetafield: 为产品创建元字段
  • deleteMetafield: 删除元字段

Shop

  • getShopInfo: 获取店铺信息
  • updateShopInfo: 更新店铺信息

常见问题解答

  • 需要 Shopify Admin API 访问令牌,可以在 Shopify 管理后台的 Apps > Develop apps 中创建。

使用教程

使用依赖

  1. 确保已安装 Node.js 和 npm。

安装教程

  1. 克隆仓库
  2. 安装依赖: npm install
  3. 创建 .env 文件并添加 Shopify 凭证: SHOPIFY_SHOP_NAME=your-shop-name SHOPIFY_ACCESS_TOKEN=your-access-token

调试方式

  1. 启动服务器: npm run dev
  2. 使用 MCP Inspector 测试: npm run inspect

许可证

None