适用于 Claude Desktop 的 Shopify MCP 服务器

这是一个简单的模型上下文协议 (MCP) 服务器，可将您的 Shopify 商店数据连接到 Claude Desktop，从而允许 Claude 访问您的商店信息。

设置

1. 安装依赖项：

   npm install
   

2. 创建一个包含您的 Shopify 凭据的 .env 文件：

   SHOPIFY_STORE_NAME=您的商店名称
   SHOPIFY_API_ACCESS_TOKEN=您的访问令牌
   

3. 构建 TypeScript 代码：

   npm run build
   

4. 运行 MCP 服务器：

   npm start
   

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

功能

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

产品工具

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

• 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 服务器的传输，允许您为上传的图像指定替代文本和可选文件名。

放弃工具

• get_abandonment: 此工具检索有关按 ID 放弃的购物车或结账的详细信息。 它返回有关放弃的购物车的数据，包括商品、价格、客户信息（如果可用）和放弃时间。 您可以自定义在响应中返回哪些字段。

GraphQL 工具

• query_shopify: 此工具针对 Shopify Admin API 执行自定义 GraphQL 查询或变更。 它允许完全灵活地访问专用工具未涵盖的任何 Shopify Admin API 端点，并提供传递变量和启用变更操作的选项。

• introspect_admin_schema: 此工具内省并返回与用户提示相关的 Shopify Admin API GraphQL 模式的部分。 仅将其用于 Shopify Admin API，而不用于任何其他 API，如 Shopify Storefront API 或 Shopify Functions API。 它接受搜索词以按名称过滤模式元素，并提供专注于特定部分（如类型、查询或变更）的选项。

许可证

MIT