🚀 Shopify MCP 服务器用于 Claude 桌面版

这是一个简单的模型上下文协议（MCP）服务器，它能将您的 Shopify 店铺数据连接到 Claude 桌面版，让 Claude 可以访问您的商店信息。

🚀 快速开始

本服务器可将您的 Shopify 店铺数据与 Claude 桌面版相连接，使 Claude 能够访问您的店铺信息。以下是具体的使用步骤。

📦 安装指南

1. 安装依赖项：

   npm install
   

2. 创建一个 .env 文件，添加您的 Shopify 凭据：

   SHOPIFY_STORE_NAME=your-store-name
   SHOPIFY_API_ACCESS_TOKEN=your-access-token
   

3. 构建 TypeScript 代码：

   npm run build
   

4. 运行 MCP 服务器：

   npm start
   

5. 在 Claude 桌面版中，设置 MCP 服务器指向此服务器。现在您应该能够访问您的 Shopify 数据。

✨ 主要特性

此服务器通过 MCP 工具提供以下 Shopify 功能：

产品工具

• create_product：此工具创建具有选项（例如颜色、尺寸）的产品结构，并将状态设为 DRAFT。它处理产品标题、描述、供应商、类型、标签和选项配置，但不创建带有价格的变体。这是产品创建的第一步。

• browse_products：此工具检索产品的列表，可选包含库存信息。它支持分页并提供关键产品详细信息，如标题、描述、图像、变体和库存状态。当提供特定的 product_id 时，它返回该单个产品的详细信息。

• update_variant_price：此工具更新特定产品变体的价格和/或比较价格。它可以设置新的常规价格、添加/更新比较价格或通过传递 null 或空字符串移除比较价格。

库存工具

• list_inventory_items：此工具检索库存项目的列表，可选按 SKU 过滤。它支持分页并提供库存详细信息，如可用数量、成本和库存位置。

• get_inventory_item：此工具检索特定库存项目（按 ID 或 SKU）的详细信息。它返回全面的库存数据，包括是否跟踪、所有位置的可用数量以及关联的变体信息。

• update_inventory_quantity：此工具更新特定位置的库存项目的可用数量。它接受库存项目 ID、位置 ID 和新可用数量，并返回调整后的库存水平。

订单工具

• browse_orders：此工具检索 Shopify 订单，带有强大的过滤选项。它支持按状态、日期范围、客户电子邮件、财务状态和履行状态进行过滤，并允许通过订单号或客户详细信息搜索。当提供特定的 order_id 时，它返回该单个订单的详细信息。

客户工具

• browse_customers：此工具检索客户信息和消费数据，带有高级过滤选项。它支持按多个字段排序、按最小/最大消费过滤，并返回详细的客户配置文件。当提供特定的 customer_id 时，它返回该单个客户的全面信息。

媒体工具

• upload_image_from_url：此工具从公开 URL 上传图像到 Shopify CDN 文件部分。它处理将图像数据传输到 Shopify 服务器，并允许指定 alt 文本和可选文件名。

放弃工具

• get_abandonment：此工具检索特定购物车或结账放弃的详细信息。它返回有关 abandoned 购物车的数据，包括项目、价格、客户信息（如有）以及 abandon timing。您可以自定义响应中返回的字段。

GraphQL 工具

• query_shopify：此工具执行 Shopify 管理 API 的自定义 GraphQL 查询或突变。它允许完全灵活地访问任何未被专业工具覆盖的 Shopify 管理 API 终端点，并提供传递变量和启用突变操作的选项。

• introspect_admin_schema：此工具 introspects 并返回与用户提示相关的 Shopify 管理 API GraphQL 模式的部分。仅用于 Shopify 管理 API，而不用于其他任何 API，如 Shopify 前台 API 或 Shopify Functions API。它接受搜索词以按名称过滤模式元素，并提供选项专注于特定部分，例如类型、查询或突变。

📄 许可证

MIT