Shopify MCP Server

社区

面向 AI 助手的 Shopify Admin GraphQL API 的 MCP 服务器

分类: 开发工具第 380 / 438
Stars: ★ 143 热门
传输方式: stdio（本地进程）
运行环境: Node.js 18+ · Docker
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 27 天前

36FMRS · D

根据 README，该服务器是 Shopify 的精心构建的 MCP 集成，提供 40 个工具和强大的功能，如 OAuth、Redis 缓存和结构化日志。它适合希望在 MCP 生态系统中使用 Shopify Admin API 的开发者，但需要谨慎处理凭据，并注意其非官方性质。

最强项 · 文档质量 11/20 最弱项 · 可靠性 5/20

可靠性

5/20

安全与权限

5/20

维护活跃度

6/20

文档质量

11/20

安装易用性

9/20

查看各项评分依据

可靠性 5/20: 仅提供 README，未提供 package.json、工具清单或可运行代码。README 中“从源码安装”的仓库地址指向 GeLi2001/shopify-mcp 而非本仓库，且声称 40 个工具但无清单可核对；未提供 CI 或测试证据，无法确认 MCP 握手与工具行为是否真实匹配。
安全与权限 5/20: 静态 token/OAuth 密钥仅通过环境变量或 CLI 传入，但未见加密、最小权限或密钥轮换说明；Redis 缓存 token 的访问控制未交代。CRUD/退款/取消等危险操作未见确认机制或数据边界说明。无源码，无法排除凭据泄露或过度授权风险。
维护活跃度 6/20: 仓库未归档、MIT 许可、0 个 open issues，但无提交/发布/issue 响应数据；README 中提到的 CI 无法验证，且克隆地址不一致，活跃维护的证据不足。
文档质量 11/20: README 结构完整，包含安装、环境变量、故障排查和 FAQ，但缺少工具参数、速率限制、成本说明，且“从源码安装”的 URL 错误；没有可验证的示例输出或截图。
安装易用性 9/20: 提供了 npx 和 Claude Desktop 配置示例，步骤清晰；但未验证 npm 包是否存在，克隆 URL 指向错误仓库，且无 CI/测试证据支持安装路径可复现。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

希望使用 AI 助手管理 Shopify 商店的开发者
需要从 MCP 兼容工具中编程访问 Shopify Admin API 的项目
寻求现成的、生产级 Shopify MCP 服务器的团队

不适合谁

不需要管理 Shopify 商店或不需要访问 Admin API 的用户
寻求使用 Shopify Storefront API 的服务器（该服务器仅使用 Admin API）
寻找官方维护的 MCP 服务器的用户（此服务器未由 Shopify 官方维护）

所需权限

Shopify Admin API 访问权限，需要自定义应用和 Admin API 作用域，包括 `read_products`、`write_products`、`read_customers`、`write_customers`、`read_orders`、`write_orders`（根据需要使用库存/元字段作用域）
可选的 Redis 连接，用于 OAuth 令牌持久化（如果启用）
环境变量或 CLI 参数中的凭据（访问令牌或客户端 ID/密钥）

风险与副作用

凭据可能被暴露：确保安全存储客户端密钥或访问令牌
由于提供写权限，可能存在数据丢失或损坏的风险（允许写入操作）
使用非官方服务器可能带来安全或兼容性问题，请自行审查代码
启用 Redis 时，如果 Redis 配置不当，可能导致启动失败或令牌缓存问题

安装接入

准备工作

运行环境：Node.js 18+ · Docker

MYSHOPIFY_DOMAIN 必填你的店铺域名，如 store.myshopify.com，来自你的 Shopify 商店。

SHOPIFY_ACCESS_TOKEN 可选密钥静态 shpat_ 访问令牌（旧版自定义应用），从 Shopify 自定义应用获取；与 client credentials 二选一。

SHOPIFY_CLIENT_SECRET 可选密钥 Shopify Dev Dashboard 应用的客户端密钥，与 SHOPIFY_CLIENT_ID 搭配使用。

其他可选配置项（8 个）

SHOPIFY_CLIENT_ID 可选 Shopify Dev Dashboard 应用的客户端 ID。

SHOPIFY_API_VERSION 可选 Admin GraphQL API 版本，默认 2026-01，一般无需设置。

LOG_LEVEL 可选日志级别，可选 debug/info/warn/error。

REDIS_ENABLED 可选是否启用 Redis 缓存 OAuth 令牌，true/false。

REDIS_URL 可选 Redis 连接地址，如 redis://127.0.0.1:6379，启用 Redis 时必需。

REDIS_KEY_PREFIX 可选 Redis 键命名前缀，默认 shopify-mcp:。

REDIS_MAX_RETRIES 可选 Redis 命令最大重试次数，默认 10。

REDIS_CONNECT_TIMEOUT_MS 可选 Redis 连接超时（毫秒），默认 10000。

确保已安装 Node.js 18 或更高版本。
使用 npx 运行：npx shopify-mcp --clientId YOUR_CLIENT_ID --clientSecret YOUR_CLIENT_SECRET --domain your-store.myshopify.com
或者从源码安装：克隆仓库，npm install，npm run build，然后 npm start。
对于 Claude Desktop，将提供的 JSON 配置添加到 claude_desktop_config.json（macOS：~/Library/Application Support/Claude/claude_desktop_config.json；Windows：%APPDATA%/Claude/claude_desktop_config.json）。

claude_desktop_config.json

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": [
        "shopify-mcp",
        "--clientId",
        "<CLIENT_ID>",
        "--clientSecret",
        "<CLIENT_SECRET>",
        "--domain",
        "<store>.myshopify.com"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "shopify": {
      "command": "npx",
      "args": [
        "shopify-mcp",
        "--clientId",
        "<CLIENT_ID>",
        "--clientSecret",
        "<CLIENT_SECRET>",
        "--domain",
        "<store>.myshopify.com"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add shopify -- npx shopify-mcp --clientId '<CLIENT_ID>' --clientSecret '<CLIENT_SECRET>' --domain '<store>.myshopify.com'

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 Claude Desktop 中添加配置并重启后，工具列表中应出现 shopify 服务器的产品/订单/客户等工具；询问“我的商店域名是什么”或让它列几个产品，能返回真实数据即说明连接成功。

常见排障

认证错误：确保提供 `SHOPIFY_ACCESS_TOKEN` 或同时提供 `SHOPIFY_CLIENT_ID` 和 `SHOPIFY_CLIENT_SECRET`
MCP 连接问题：检查 Claude Desktop 的 MCP 日志（例如 macOS 上执行 `tail -f ~/Library/Logs/Claude/mcp*.log`），并确保服务器启动无错误
Redis 连接失败：如果 `REDIS_ENABLED=true` 但 Redis 不可达，服务器将退出。请启动本地 Redis（例如使用 Docker）或设置 `REDIS_ENABLED=false`
GraphQL userErrors：Shopify 在变更响应中返回字段级错误，服务器将其显示为 `Failed to <operation>: field: message`，请根据这些错误调整操作

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我商店里的前10个产品及其库存状态
查询最近一周的未发货订单并汇总订单总额
给指定的产品添加一个名为 care_instructions 的 metafield
把某款产品的库存数量调整为 25

使用场景

通过 AI 助手管理 Shopify 商店的产品、客户、订单、库存和元字段

自动执行常见的电商管理任务，如订单处理、库存更新和客户支持

将 MCP 兼容客户端与 Shopify Admin API 集成，进行数据查询和操作

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

一个面向生产的 Model Context Protocol (MCP) 服务器，将 Shopify Admin GraphQL API 暴露给 AI 助手。允许 Claude Desktop、Claude Code 或任何兼容 MCP 的客户端，通过类型化工具接口管理产品、客户、订单、库存和元字段。该服务器将 MCP 工具调用转换为 Shopify Admin GraphQL 操作，支持静态访问令牌和 OAuth 客户端凭据（Dev Dashboard 应用），可选 Redis 后端令牌持久化、结构化 JSON 日志和优雅关闭。