关键词

ShopifyGraphQL API电商商店管理数据访问

项目简介

Shopify MCP Server 是一个专为Shopify平台设计的 Model Context Protocol (MCP) 服务器。它允许LLM（大型语言模型）客户端安全、便捷地访问和操作Shopify店铺的各项数据，例如商品、客户和订单信息。通过标准化的MCP协议，该服务器充当LLM与Shopify API之间的桥梁，使得开发者可以构建基于LLM的智能电商应用。

主要功能点

  • 商品管理: 支持检索商品信息，可以根据关键词搜索商品。
  • 客户管理: 支持加载客户数据，方便进行客户信息查询和管理。
  • 订单管理: 支持高级订单查询和筛选，帮助用户快速定位订单。
  • 数据操作: 支持更新订单信息，例如添加标签、修改备注等。
  • GraphQL集成: 直接与Shopify GraphQL Admin API集成，保证数据访问的高效和实时性。
  • 清晰的错误处理: 提供详细的错误信息，帮助开发者快速定位和解决API调用或认证问题。

安装步骤

  1. 安装 Node.js: 确保你的电脑上已安装 Node.js (版本 16 或更高)。你可以从 Node.js官网 下载并安装。
  2. 安装 Shopify MCP Server: 你可以选择全局安装或在项目本地安装。推荐使用 'npx' 直接运行，无需全局安装。

服务器配置

为了让MCP客户端（例如 Claude Desktop）连接到 Shopify MCP Server，你需要配置客户端的 'claude_desktop_config.json' 文件。以下是配置示例，请根据你的实际情况修改：

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": [
        "shopify-mcp-server",
        "--accessToken",
        "<YOUR_SHOPIFY_ADMIN_API_访问令牌>",  // 替换为你的 Shopify Admin API 访问令牌
        "--domain",
        "<YOUR_SHOPIFY_店铺域名>.myshopify.com" // 替换为你的 Shopify 店铺域名，例如 your-store.myshopify.com
      ]
    }
  }
}

配置参数说明:

  • server name (shopify): 服务器名称，可以自定义，用于在MCP客户端中标识该服务器。
  • command (npx): 启动服务器的命令，这里使用 'npx' 来运行 'shopify-mcp-server'。
  • args: 传递给服务器的命令行参数，包括：
    • '--accessToken': 必须，你的 Shopify Admin API 访问令牌。请参考 Setup -> Shopify Access Token 步骤获取。
    • '--domain': 必须，你的 Shopify 店铺域名 (例如 'your-store.myshopify.com')。

Claude Desktop 配置文件位置:

  • MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
  • Windows: '%APPDATA%/Claude/claude_desktop_config.json'

Shopify Access Token 获取步骤:

  1. 登录你的 Shopify 管理后台。
  2. 进入 设置 -> 应用和销售渠道。
  3. 点击 开发应用 (可能需要先启用开发者预览)。
  4. 点击 创建应用。
  5. 设置应用名称 (例如 "Shopify MCP Server")。
  6. 点击 配置 Admin API 范围。
  7. 选择以下 范围 (根据你的需求选择读或写权限):
    • 'read_products', 'write_products' (商品)
    • 'read_customers', 'write_customers' (客户)
    • 'read_orders', 'write_orders' (订单)
  8. 点击 保存。
  9. 点击 安装应用。
  10. 点击 安装 以授权应用访问你的店铺数据。
  11. 安装完成后，你将看到 Admin API 访问令牌。
  12. 复制这个令牌，并将其填入 'claude_desktop_config.json' 配置文件中的 '<YOUR_SHOPIFY_ADMIN_API_访问令牌>' 位置。

基本使用方法

配置完成后，MCP客户端（如 Claude Desktop）应该能够连接到 Shopify MCP Server。你可以通过客户端的功能调用服务器提供的工具，例如：

  • 使用 'get-products' 工具查询商品信息，可以指定 'searchTitle' 参数按标题搜索，或使用 'limit' 参数限制返回商品数量。
  • 使用 'get-customers' 工具获取客户列表，可以根据 'searchQuery' 参数按姓名或邮箱搜索。
  • 使用 'get-orders' 工具查询订单，可以根据 'status' 参数筛选订单状态。
  • 使用 'get-product-by-id' 工具通过商品ID获取特定商品的详细信息。
  • 使用 'update-order' 工具更新订单信息，例如添加订单标签或备注。

具体工具的使用方法和参数，请参考仓库 README.md 文件中 Available Tools 章节的详细说明。

信息

分类

商业系统

访问项目