Shopify Admin GraphQL MCP 服务器

一个全面的模型上下文协议 (MCP) 服务器，用于与 Shopify 的 Admin GraphQL API 交互。此服务器提供用于管理产品、订单、客户、库存、折扣、元字段和商店信息的工具和资源。

## 功能

- 完整覆盖关键的 Shopify Admin API 功能
- 为所有主要的 Shopify 资源提供结构化工具
- 为每个 API 部分提供文档资源
- 易于与任何 MCP 兼容的客户端一起使用

## 设置

1. 克隆此仓库
2. 安装依赖项：
   ```
   npm install
   ```
3. 创建一个包含您的 Shopify 凭据的 `.env` 文件：
   ```
   SHOPIFY_SHOP_NAME=您的商店名称
   SHOPIFY_ACCESS_TOKEN=您的访问令牌
   ```

## 用法

启动服务器：
```
npm run dev
```

使用 MCP Inspector 进行测试：
```
npm run inspect
```

## 可用工具

### 产品
- 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}` 资源访问文档，其中 section 可以是：
- overview (概述)
- products (产品)
- orders (订单)
- customers (客户)
- inventory (库存)
- discounts (折扣)
- metafields (元字段)
- shop (商店)

## 身份验证

此服务器需要 Shopify Admin API 访问令牌。您可以在 Shopify 管理后台的“应用”>“开发应用”中创建一个。