Shopify MCP Server

基本能力

产品定位

Shopify MCP Server 是一个用于与 Shopify API 交互的服务，通过 GraphQL API 实现与商店数据的交互。

核心功能

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

适用场景

• 电子商务平台的开发和管理
• 产品、客户和订单的数据管理
• 自动化商店操作

工具列表

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

常见问题解答

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

使用教程

使用依赖

1. 安装 Node.js 和 npm
2. 确保已安装 Git

安装教程

1. 克隆仓库：

git clone <repository-url>

1. 安装依赖：

npm install

1. 创建 .env 文件并配置 Shopify 访问令牌和域名：

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

1. 构建项目：

npm run build

调试方式

1. 运行测试：

npm test

1. 启动服务：

npm start

许可证

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