Shopify MCP Server for Claude Desktop

Claude Desktop 的 Shopify MCP 服务

这是一个简单的模型上下文协议（MCP）服务，可将 Shopify 商店数据连接到 Claude Desktop，让 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 Desktop 中将 MCP 服务设置为指向此服务。现在，你应该可以访问 Shopify 数据了。

功能

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

产品工具

• create_product：此工具会创建包含选项（例如 Color、Size）的产品结构，状态为 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 的 Files 区域。它会将图片数据传输到 Shopify 服务器，并允许你为上传的图片指定替代文本和可选文件名。

弃购工具

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

GraphQL 工具

• query_shopify：此工具可针对 Shopify Admin API 执行自定义 GraphQL 查询或变更。它提供全面的灵活性，可访问专用工具未涵盖的任何 Shopify Admin API 端点，并支持传递变量和启用变更操作。

• introspect_admin_schema：此工具可内省并返回与用户提示相关的 Shopify Admin API GraphQL 架构部分。仅将其用于 Shopify Admin API，不要用于 Shopify Storefront API 或 Shopify Functions API 等其他 API。它接受搜索词来按名称筛选架构元素，并提供选项以聚焦于类型、查询或变更等特定部分。

许可证

MIT