这是一个简单的模型上下文协议(MCP)服务器,用于连接您的Shopify店铺数据到Claude Desktop,使Claude能够访问您的店铺信息。
安装依赖项:
npm install
创建一个包含您的Shopify凭证的.env文件:
SHOPIFY_STORE_NAME=your-store-name
SHOPIFY_API_ACCESS_TOKEN=your-access-token
构建TypeScript代码:
npm run build
运行MCP服务器:
npm start
在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检索关于购物车或结账放弃的详细信息。它返回关于被放弃购物车的数据,包括项目、价格、客户信息(如果可用)以及放弃时间。您可以自定义响应中返回的字段。query_shopify:此工具执行针对Shopify管理API的自定义GraphQL查询或突变。它允许完全灵活性以访问任何未被专用工具覆盖的Shopify管理API端点,并提供传递变量和启用突变操作的选项。
introspect_admin_schema:此工具内省并返回与用户提示相关的Shopify管理API GraphQL模式的部分。仅用于Shopify管理API,而不是其他API,如Shopify店面API或Shopify函数API。它接受搜索词以按名称过滤模式元素,并提供选项专注于特定部分,如类型、查询或突变。
MIT