Shopify MCP Server

基本能力

产品定位

Shopify MCP Server 是一个中间件服务，用于与 Shopify API 交互，提供对商店数据的访问和管理功能。

核心功能

• 产品管理：搜索和检索产品信息
• 客户管理：加载客户数据和管理客户标签
• 订单管理：高级订单查询和过滤
• GraphQL 集成：直接与 Shopify 的 GraphQL Admin API 集成
• 全面的错误处理：清晰的 API 和认证错误消息

适用场景

• 电子商务平台的开发和管理
• 自动化商店数据管理
• 集成 Shopify 功能到其他系统

工具列表

1. get-products：获取所有产品或按标题搜索
2. get-products-by-collection：从特定集合获取产品
3. get-products-by-ids：按 ID 获取产品
4. get-variants-by-ids：按 ID 获取产品变体
5. get-customers：获取 Shopify 客户（支持分页）
6. tag-customer：为客户添加标签
7. get-orders：获取订单（支持高级过滤和排序）
8. get-order：按 ID 获取单个订单
9. create-discount：创建折扣码
10. create-draft-order：创建草稿订单
11. complete-draft-order：完成草稿订单
12. get-collections：获取所有集合
13. get-shop：获取商店详情
14. get-shop-details：获取扩展商店详情（包括运输国家）
15. manage-webhook：订阅、查找或取消订阅 webhook

常见问题解答

• 如何获取 Shopify 访问令牌？
• 需要在 Shopify 商店中创建自定义应用并配置适当的 API 范围。
• 如何配置 Claude Desktop 使用此服务？
• 需要在 claude_desktop_config.json 中添加配置信息。

使用教程

使用依赖

1. 确保已安装 Node.js 和 npm
2. 安装项目依赖：

npm install

安装教程

1. 克隆仓库
2. 创建 .env 文件并配置 Shopify 访问令牌和域名：

SHOPIFY_ACCESS_TOKEN=your_access_token
MYSHOPIFY_DOMAIN=your-store.myshopify.com

1. 构建项目：

npm run build

调试方式

1. 运行测试：

npm test

1. 检查 .env 文件配置是否正确
2. 确保 Shopify 访问令牌具有必要的 API 权限

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。