星战科技xingzhan.cloud
返回市场
Shopify-MCP服务器

Shopify-MCP服务器

作者：antoineschaller2 星标更新：2025-08-04
安装使用来源：spider==github.com

项目介绍

MCP Shopify

一个全面的模型上下文协议（MCP）服务器，用于Shopify管理API集成。该服务器提供了22种工具，可以与您的Shopify商店进行交互，使像Claude这样的AI助手能够通过自然语言来管理产品、订单、客户、库存、分析等。

功能

  • 产品管理：列出、搜索、创建、更新和管理产品及其变体
  • 订单管理：查看和更新订单，完成订单，管理交易
  • 客户管理：搜索和管理客户数据
  • 库存管理：跟踪和更新库存水平
  • 分析：访问商店分析和报告
  • 集合：管理产品集合
  • 折扣：创建和管理折扣码
  • 更多功能！

安装

全局安装（推荐）

npm install -g @akson/mcp-shopify

局部安装

npm install @akson/mcp-shopify

使用方法

环境变量

export SHOPIFY_ACCESS_TOKEN=your-access-token
export SHOPIFY_DOMAIN=your-store.myshopify.com
mcp-shopify

命令行参数

mcp-shopify --accessToken=your-access-token --domain=your-store.myshopify.com

与Claude桌面应用结合使用

  1. 全局安装包：

    npm install -g @akson/mcp-shopify

  2. 查找您的Claude桌面配置文件：

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json

  3. 将Shopify MCP服务器添加到您的配置中：

    {
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": ["@akson/mcp-shopify"],
      "env": {
        "SHOPIFY_ACCESS_TOKEN": "your-access-token",
        "SHOPIFY_DOMAIN": "your-store.myshopify.com"
      }
    }
  }
}

  4. 重启Claude桌面以加载新服务器

可用工具

产品管理

  • list_products - 列出所有产品并使用过滤器
  • get_product - 获取详细的产品信息
  • search_products - 按标题搜索产品
  • create_product - 创建新产品
  • update_product - 更新产品详情
  • delete_product - 删除产品
  • update_inventory - 更新库存水平

订单管理

  • list_orders - 列出订单并使用过滤器
  • get_order - 获取详细的订单信息
  • update_order - 更新订单详情
  • fulfill_order - 完成订单
  • cancel_order - 取消订单
  • create_order_note - 向订单添加备注

客户管理

  • list_customers - 列出所有客户
  • search_customers - 搜索客户
  • get_customer - 获取客户详情
  • create_customer - 创建新客户

分析与报告

  • get_analytics - 获取商店分析
  • get_reports - 访问各种报告

其他功能

  • list_collections - 管理集合
  • create_discount - 创建折扣码
  • list_locations - 查看商店位置

要求

  • Node.js >= 14.0.0
  • Shopify管理API访问令牌
  • Shopify商店域名

API访问

要使用此服务器，您需要：

  1. 一个Shopify商店
  2. 一个具有适当API权限的私有应用程序或自定义应用程序
  3. 一个管理API访问令牌

快速开始

1. 创建Shopify应用程序

  1. 登录到您的Shopify管理面板
  2. 导航至设置 → 应用程序和销售渠道 → 开发应用程序
  3. 创建一个新的应用程序或使用现有的应用程序
  4. 配置管理API范围（读写权限，如产品、订单、客户等）
  5. 将应用程序安装到您的商店
  6. 复制管理API访问令牌

2. 配置服务器

使用以下方法之一设置您的凭据：

环境变量（推荐）：

export SHOPIFY_ACCESS_TOKEN="your-access-token"
export SHOPIFY_DOMAIN="your-store.myshopify.com"

命令行参数：

mcp-shopify --accessToken="your-token" --domain="your-store.myshopify.com"

安全性

  • 切勿将访问令牌提交到版本控制
  • 使用环境变量存储敏感数据
  • 安全地存储令牌（例如，在密码管理器或安全金库中）
  • 确保API令牌只有必要的权限
  • 定期轮换访问令牌
  • 通过Shopify管理面板监控API使用情况

示例

在Claude桌面应用中配置后，您可以要求Claude执行以下操作：

  • "显示我最畅销的前10款产品"
  • "将产品SKU123的价格更新为$29.99"
  • "列出过去一周的所有待处理订单"
  • "为夏季商品创建一个新的产品集合"
  • "检查库存水平低的产品"
  • "生成本月的销售报告"
  • "查找所有来自纽约的客户"
  • "在未来一周内应用20%的折扣码"

故障排除

常见问题

  1. "SHOPIFY_ACCESS_TOKEN和SHOPIFY_DOMAIN是必需的"

    • 确保环境变量设置正确
    • 检查您的shell配置是否加载了这些变量

  2. "401未授权"错误

    • 验证您的访问令牌是否正确
    • 检查您的应用程序是否有所需的API权限
    • 确保令牌没有过期

  3. "在Claude桌面中找不到服务器"

    • 验证包是否全局安装：`npm list -g @akson/mcp-shop
    • 检查配置文件路径是否正确
    • 在更改配置后重启Claude桌面

贡献

欢迎贡献！请随时提交拉取请求。

许可证

MIT

支持

对于问题和功能请求，请访问：https://github.com/antoineschaller/mcp-shopify/issues

更新日志

v1.0.0

  • 初始发布，包含22个全面的Shopify工具
  • 完整的ES模块支持
  • 命令行和环境变量配置
  • Claude桌面应用集成