Rezapex Shopify MCP Server Main

🚀 Shopify MCP 服务器

Shopify MCP 服务器是一款强大的工具，可借助 GraphQL API 与 Shopify 商店的数据进行交互。它提供了丰富的功能，能有效管理产品、客户和订单等信息，还具备完善的错误处理机制。

✨ 主要特性

• 产品管理：支持创建、更新和删除产品，方便对商品信息进行维护。
• 客户管理：可对客户信息进行有效管理，提升客户服务质量。
• 订单处理：能够处理和跟踪订单，确保订单流程的顺畅。
• GraphQL 请求：借助 GraphQL 客户端访问 Shopify API，灵活获取所需数据。
• 错误处理：拥有全面的错误处理机制，保障系统的稳定性。

📦 安装指南

获取 Shopify 访问令牌

为了使用此 MCP 服务器，您需要创建一个自定义应用并获取访问令牌：

1. 登录您的 Shopify 管理界面。
2. 进入 Settings > Apps and sales channels。
3. 点击 Develop apps（可能需要启用开发者预览）。
4. 点击 Create an app，设置应用名称（例如："Shopify MCP Server"）。
5. 配置 Admin API 作用域，选择以下范围：
   • read_products, write_products
   • read_customers, write_customers
   • read_orders, write_orders
6. 安装应用并获取访问令牌。

在 Claude Desktop 上使用

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": ["-y", "shopify-mcp-server"],
      "env": {
        "SHOPIFY_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>",
        "MYSHOPIFY_DOMAIN": "<YOUR_SHOP>.myshopify.com"
      }
    }
  }
}

💻 使用示例

基础用法

1. 获取产品

get-products [--searchTitle <SEARCH_TITLE>] [--limit <LIMIT>]

此命令用于获取 Shopify 商店中的产品。可以使用可选参数 --searchTitle 搜索特定标题的产品，并使用 --limit 设置返回的最大数量。

get-products --searchTitle "apple" --limit 10

2. 创建产品

create-product <PRODUCT_NAME> <DESCRIPTION> <PRICE>

此命令用于创建一个新的 Shopify 产品，需要提供产品的名称、描述和价格。

create-product "New iPhone" "Latest model with advanced features." 999.99

3. 更新产品

update-product <PRODUCT_ID> [--setTitle <NEW_TITLE>] [--setDescription <NEW_DESCRIPTION>] [--setPrice <NEW_PRICE>]

此命令用于更新指定 ID 的产品。可以使用可选参数 --setTitle、--setDescription 和 --setPrice 更新产品的标题、描述和价格。

update-product 123 --setTitle "Updated iPhone" --setDescription "Enhanced features released." --setPrice 1099.99

4. 删除产品

delete-product <PRODUCT_ID>

此命令用于删除指定 ID 的产品。

delete-product 123

📚 详细文档

开发信息

1. 克隆仓库：

git clone https://github.com/your-username/shopify-mcp-server.git

2. 安装依赖项：

npm install

3. 创建 .env 文件：

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

4. 构建项目：

npm run build

5. 运行测试：

npm test

依赖项

• @modelcontextprotocol/sdk - MCP 协议实现
• graphql-request - Shopify API 的 GraphQL 客户端
• zod - 运行时类型验证

贡献指南

欢迎贡献！请先阅读我们的 Contributing Guidelines。

社区资源

• MCP GitHub Discussions
• 报告问题

📄 许可证

MIT

此文档详细介绍了 Shopify MCP 服务器的功能、工具及其使用方法。