返回市场
商铺管理平台

商铺管理平台

作者:codeyogi9114 星标更新:2025-04-03

项目介绍

Shopify MCP Server for Claude Desktop

这是一个简单的模型上下文协议(MCP)服务器,用于连接您的Shopify店铺数据到Claude Desktop,使Claude能够访问您的店铺信息。

配置

  1. 安装依赖项:

    npm install
    
  2. 创建一个包含您的Shopify凭证的.env文件:

    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:此工具创建具有选项(例如颜色、尺寸)的产品结构,并将其置于草稿状态。它处理产品标题、描述、供应商、类型、标签和选项配置,但不创建带有价格的变体。这是产品创建的第一步。

  • browse_products:此工具检索产品列表,可选地包括库存信息。它支持分页并提供关键的产品详情,如标题、描述、图片、变体和库存水平。当提供特定的产品ID时,它返回该单个产品的详细信息。

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

库存工具

  • list_inventory_items:此工具检索库存项目列表,可选地按SKU过滤。它支持分页并提供库存详情,如可用数量、成本以及库存地点。

  • get_inventory_item:此工具根据ID或SKU检索特定库存项目的详细信息。它返回全面的库存数据,包括跟踪状态、所有地点的可用数量以及相关的变体信息。

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

订单工具

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

客户工具

  • browse_customers:此工具检索客户信息,包括消费数据和高级筛选选项。它支持按多个字段排序,按最低/最高消费金额筛选,并返回详细的客户档案。当提供特定的客户ID时,它返回该单个客户的全面信息。

媒体工具

  • upload_image_from_url:此工具从公共URL上传图像到Shopify CDN文件部分。它处理图像数据向Shopify服务器的传输,允许您指定上传图像的alt文本和可选文件名。

购物车放弃工具

  • get_abandonment:此工具根据ID检索关于购物车或结账放弃的详细信息。它返回关于被放弃购物车的数据,包括项目、价格、客户信息(如果可用)以及放弃时间。您可以自定义响应中返回的字段。

GraphQL工具

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

  • introspect_admin_schema:此工具内省并返回与用户提示相关的Shopify管理API GraphQL模式的部分。仅用于Shopify管理API,而不是其他API,如Shopify店面API或Shopify函数API。它接受搜索词以按名称过滤模式元素,并提供选项专注于特定部分,如类型、查询或突变。

许可证

MIT