Shopify MCP 服务器

简介

Shopify MCP 服务器是一个基于 Model Context Protocol (MCP) 的工具，用于与 Shopify 商店交互。它提供了一系列 GraphQL API 接口，方便开发者进行商品、客户、订单等数据的管理。

功能特点

• 强大的 GraphQL 支持：通过 GraphQL 请求直接操作 Shopify 数据。
• 灵活的 MCP 协议：利用 MCP 的上下文模型协议实现高效的数据交互。
• 多场景支持：适用于商品管理、客户关系维护、订单处理等多种业务场景。

工具列表

以下是服务器提供的主要工具：

商品管理

1. get-products：获取指定条件下的商品信息。
2. create-product：创建新的商品。
3. update-product：更新现有商品的详细信息。
4. delete-product：删除指定商品。

客户管理

5. get-customers：列出所有客户信息。
6. create-customer：添加新客户。
7. update-customer：修改客户资料。
8. delete-customer：移除指定客户。

订单处理

9. get-orders：获取订单列表。
10. create-order：生成新的订单。
11. update-order：更新订单状态或信息。
12. cancel-order：取消未完成的订单。

其他功能

13. get-collections：获取商品集合信息。
14. manage-webhook：订阅、查找或取消 webhook 事件。
15. get-shop：获取商店的基本信息。
16. get-shop-details：获取商店的详细配置，包括可用配送国家等。

快速上手

Shopify 访问令牌

为了使用本服务器，请按照以下步骤创建一个自定义应用并获取访问令牌：

1. 登录 Shopify 管理界面。
2. 进入 设置 > 应用和销售渠道。
3. 点击 开发应用（可能需要先启用开发者预览）。
4. 创建新应用，命名为“Shopify MCP 服务器”或其他方便记忆的名字。
5. 配置 Admin API 权限范围：
   • 读取和写入商品 (read_products, write_products)
   • 读取和写入客户 (read_customers, write_customers)
   • 读取和写入订单 (read_orders, write_orders)
6. 安装应用并获取 Admin API 访问令牌。

注意：请妥善保管访问令牌，避免泄露或误传至版本控制系统。

使用示例

在 Claude Desktop 中使用本服务器：

1. 创建或编辑 claude_desktop_config.json 文件。
2. 添加以下配置：

   {
     "mcpServers": {
       "shopify": {
         "command": "npx",
         "args": ["-y", "shopify-mcp-server"],
         "env": {
           "SHOPIFY_ACCESS_TOKEN": "<你的访问令牌>",
           "MYSHOPIFY_DOMAIN": "<your-store>.myshopify.com"
         }
       }
     }
   }
   

3. 启动服务器并开始使用相关工具。

开发

项目结构

1. 克隆仓库：

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

2. 安装依赖：

   npm install
   

3. 创建 .env 文件：

   SHOPIFY_ACCESS_TOKEN=<你的访问令牌>
   MYSHOPIFY_DOMAIN=<your-store>.myshopify.com
   

4. 启动开发服务器：

   npm start
   

依赖项

• graphql: GraphQL 客户端库。
• axios: HTTP 请求库。
• dotenv: 环境变量加载工具。

许可证

本项目采用 MIT 许可证，详情请见 LICENSE 文件。

社区与支持

• GitHub 仓库：https://github.com/your-username/shopify-mcp-server
• 问题反馈：欢迎在 Issues 中提交 bug 或提出功能需求。
• 文档贡献：欢迎为项目文档贡献力量。

链接

• Shopify 开发文档
• Model Context Protocol (MCP)