Shopify Admin GraphQL MCP Server

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=your-shop-name
   SHOPIFY_ACCESS_TOKEN=your-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 管理后台的 Apps > Develop apps 下创建令牌。