Shopify数据连接服务

使用说明

克劳德桌面版Shopify MCP服务器

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

设置

安装依赖项：
```
npm install
```

创建一个 .env 使用您的Shopify凭据文件：

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：此工具检索具有可选库存信息的产品列表。它支持分页，并提供关键的产品详细信息，如标题、描述、图像、变体和库存水平。当提供特定的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：此工具按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。它接受搜索词以按名称过滤模式元素，并提供选项以专注于特定部分，如类型、查询或突变。