newshopify-mcp-server

🚀 Shopify 管理 GraphQL MCP 服务器

这是一个全面的 Model Context Protocol (MCP) 服务器，旨在与 Shopify 的管理 GraphQL API 进行交互。它为管理产品、订单、客户、库存、折扣、元字段以及商店信息等提供了丰富的工具和资源。

🚀 快速开始

安装步骤

1. 克隆此仓库。
2. 安装依赖项：

   npm install
   

3. 使用你的 Shopify 资格创建一个 .env 文件：

   SHOPIFY_SHOP_NAME=your-shop-name
   SHOPIFY_ACCESS_TOKEN=your-access-token
   

启动与测试

• 启动服务器：

npm run dev

• 使用 MCP 检查器测试：

npm run inspect

✨ 主要特性

• 全面覆盖关键的 Shopify 管理 API 功能。
• 结构化工具适用于所有主要的 Shopify 资源。
• 每个 API 部分都有文档资源。
• 与任何 MCP 兼容客户端易于使用。

💻 使用示例

可用工具

产品

• getProduct：按 ID 获取产品。
• listProducts：列出产品，支持分页。
• createProduct：创建新商品。
• updateProduct：更新现有产品。
• deleteProduct：删除产品。

订单

• getOrder：按 ID 获取订单。
• listOrders：列出订单，支持分页。
• cancelOrder：取消订单。

客户

• getCustomer：按 ID 获取客户。
• listCustomers：列出客户，支持分页。
• createCustomer：创建新客户。
• updateCustomer：更新现有客户。
• deleteCustomer：删除客户。

库存

• getInventoryItem：按 ID 获取库存项。
• adjustInventory：调整库存水平。
• getInventoryLevel：获取位置和项目的库存级别。

折扣

• getDiscount：按 ID 获取折扣。
• createDiscount：创建基本折扣码。
• deleteDiscount：删除折扣。

元字段

• getMetafield：按 ID 获取元字段。
• createProductMetafield：为产品创建元字段。
• deleteMetafield：删除元字段。

商店

• getShopInfo：获取有关您商店的信息。
• updateShopInfo：更新商店信息。

📚 详细文档

通过访问 shopify://docs/{section} 资源，其中部分可以是：

• overview
• products
• orders
• customers
• inventory
• discounts
• metafields
• shop

🔧 技术细节

此服务器需要 Shopify 管理 API 访问令牌。您可以在 Shopify 管理界面的 Apps > 开发应用下创建一个。