← 返回目录

Shopify MCP Server

社区

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

GitHub 源仓库 ↗

★ 139 Stars 分类 · 开发工具热门源版本 d9bf0a03155e

36FMRS · D

可靠性

5/20

安全与权限

5/20

维护活跃度

6/20

文档质量

11/20

安装易用性

9/20

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

查看 FMRS 评分方法 →

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

工具能力

暂未整理工具清单。

安装接入

确保已安装 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"
      ]
    }
  }
}

生成并校验客户端配置

选型与风险

适合谁

希望使用 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 配置不当，可能导致启动失败或令牌缓存问题

常见排障

认证错误：确保提供 `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 助手管理 Shopify 商店的产品、客户、订单、库存和元字段

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

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

支持客户端

Claude Desktop完整支持