MCP 服务器

Shopify MCP Server

wfilleman

开发者工具

访问服务器

README

Shopify MCP 服务器

一个用于将 Shopify 操作与 LLM 代理集成的模型上下文协议 (MCP) 服务器。此服务器提供了一套用于处理 Shopify 订单的工具，包括履行、跟踪、存档和检索。

功能

请求履行订单
向订单添加跟踪信息
存档订单
获取特定订单的详细信息
列出所有活跃订单

设置

前提条件

Node.js 18 或更高版本
具有 API 访问权限的 Shopify 商店

安装

克隆存储库：

git clone https://github.com/yourusername/shopify-mcp-server.git
cd shopify-mcp-server

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

基于 .env.example 创建一个 .env 文件，并添加您的 Shopify API 凭据：

SHOPIFY_API_KEY=your_api_key
SHOPIFY_API_SECRET=your_api_secret
SHOPIFY_SCOPES=write_orders,read_orders
SHOPIFY_SHOP=your-shop.myshopify.com
SHOPIFY_ACCESS_TOKEN=your_access_token

构建和运行

构建项目：
```
npm run build
```
启动服务器：
```
npm start
```
用于开发并自动重建：
```
npm run dev
```

与 LLM 代理一起使用

此服务器实现了模型上下文协议 (MCP) 并公开了以下工具：

get-order-details: 获取有关特定订单的详细信息（接受友好的订单号，如“#1001”）
get-active-orders: 获取所有活跃订单的列表
request-fulfillment: 履行订单，带有可选的跟踪信息（接受友好的订单号）
add-tracking: 向已履行的订单添加跟踪信息
archive-order: 存档订单（接受友好的订单号）

使用友好的订单号

所有需要订单 ID 的工具现在都接受友好的订单号：

#1001 - 带有 # 前缀的订单号
1001 - 没有 # 前缀的订单号
完整的 Shopify ID (gid://shopify/Order/12345) - 仍然支持

当您提供友好的订单号时，系统将自动查找正确的 Shopify ID。

更新跟踪信息

要更新订单的跟踪信息，请按照以下步骤操作：

首先，使用订单号（例如，“#1001”）使用 get-order-details 获取订单详细信息
从响应中，在“Fulfillments”部分中找到履行 ID

使用 add-tracking 工具以及履行 ID 和跟踪信息：

{
  "fulfillmentId": "gid://shopify/Fulfillment/123456789",
  "trackingNumber": "1Z999AA10123456789",
  "trackingCompany": "UPS",
  "trackingUrl": "https://www.ups.com/track?tracknum=1Z999AA10123456789",
  "notifyCustomer": true
}