shopify-mcp

🚀 Shopify MCP 服务器

Shopify MCP 服务器借助 GraphQL API 实现与 Shopify 商店的数据交互，为用户提供管理商品、客户、订单等功能的便捷工具。(如果喜欢请点个星！)

🚀 快速开始

要使用此 MCP 服务器，您需满足以下先决条件并完成相应设置：

先决条件

1. Node.js（版本 16 或更高）
2. Shopify 自定义应用访问令牌（参见下面的设置）

设置

创建自定义应用获取访问令牌

您需要在 Shopify 后台创建一个自定义应用并获取访问令牌，具体步骤如下：

1. 登录到您的 Shopify 管理员面板。
2. 导航至 应用程序 > 自定义应用。
3. 点击 新建应用。
4. 填写应用信息，包括名称和回调 URL（例如 http://localhost:8080）。
5. 保存应用后，进入应用详情页面获取 访问令牌。

此访问令牌将作为配置 MCP 服务器所需的凭据。

使用 Claude Desktop 配置

在 Claude Desktop 中使用以下 JSON 配置：

{
  "name": "Shopify MCP Server",
  "type": "process",
  "command": "npx",
  "args": [
    "shopify-mcp-server",
    "--apiKey",
    "<您的 API 密钥>",
    "--apiSecretKey",
    "<您的 API 秘钥>",
    "--host",
    "localhost",
    "--port",
    "8080"
  ],
  "stdout": {
    "filePath": "/var/log/claude/shopify-mcp-server.stdout.log",
    "maxSize": 1024,
    "numFiles": 3
  },
  "stderr": {
    "filePath": "/var/log/claude/shopify-mcp-server.stderr.log",
    "maxSize": 1024,
    "numFiles": 3
  }
}

请将 <您的 API 密钥> 和 <您的 API 秘钥> 替换为您实际的 Shopify 应用凭据。

使用环境变量

您也可以通过设置以下环境变量来配置 MCP 服务器：

• SHOPFY_API_KEY：API 访问令牌
• SHOPFY_API_SECRET_KEY：API 密钥
• MCP_HOST：默认为 localhost
• MCP_PORT：默认为 8080

直接安装

如果需要，您可以直接安装此服务器：

npm install -g shopify-mcp-server

然后运行它：

shopify-mcp-server --apiKey=<您的 API 密钥> --apiSecretKey=<您的 API 秘钥>

✨ 主要特性

• 商品管理：搜索和获取商品信息
• 客户管理：加载客户数据并管理客户标签
• 订单管理：具有高级查询和筛选功能
• GraphQL 集成：直接集成 Shopify 的 GraphQL 管理 API
• 全面错误处理：清晰的错误消息，针对 API 和身份验证问题

💻 使用示例

商品管理

基础用法

• get-products：获取商品列表

{
  "status": "active" // 可选：筛选状态，默认返回所有商品
}

高级用法

• get-product-by-id：通过 ID 获取单个商品
• update-product：更新商品信息

客户管理

基础用法

• get-customers：获取客户列表

高级用法

• get-customer-by-id：通过 ID 获取客户详细信息
• create-customer：创建新客户

{
  "email": "test@example.com",
  "first_name": "John",
  "last_name": "Doe"
}

• update-customer：更新客户信息
• delete-customer：删除客户

订单管理

基础用法

• get-orders：获取订单列表

高级用法

• get-order-by-id：通过 ID 获取订单详细信息
• create-order：创建新订单
• update-order：更新订单信息

📚 详细文档

调试

如需调试，请检查 Claude Desktop 的 MCP 日志：

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

📄 许可证

本项目采用 MIT 许可证。