Shopify MCP Server Cci

一个为Shopify与LLM代理集成设计的MCP服务器，提供订单处理、物流跟踪、归档和查询等功能。

电子商务与零售开发者工具 #Shopify集成 #订单管理 #物流跟踪 #MCP协议本地 .TypeScript

评分 : 2分

下载量 : 17

更新时间 : 2025-04-23

什么是Shopify MCP服务器？

Shopify MCP服务器是一个用于集成Shopify操作的工具，它通过Model Context Protocol（MCP）协议连接LLM（大型语言模型），实现自动化处理订单任务，例如创建发货、添加跟踪信息、归档历史订单等。

如何使用Shopify MCP服务器？

只需简单配置并运行服务器，即可通过命令行或API接口操作Shopify订单。无需手动登录Shopify后台，简化工作流程。

适用场景

适合需要频繁处理Shopify订单的商家或开发者，尤其在需要与AI助手协同工作的场景下。

主要功能

获取订单详情根据订单号（#1001）获取详细的订单信息。

请求发货一键发起订单发货，支持直接填写跟踪信息。

添加跟踪信息更新已发货订单的物流追踪状态。

归档订单将已完成或无需处理的订单存档。

列出活跃订单查看当前未完成的订单列表。

优势与局限性

优势

支持多种操作，覆盖订单生命周期全过程。

使用MCP协议，易于与LLM集成。

自动解析订单ID，无需记忆复杂格式。

避免手动访问Shopify后台，提升效率。

局限性

需要Shopify API权限（如读写订单）。

可能因API版本更新导致功能调整。

不支持个人隐私数据（如客户地址）。

如何使用

安装依赖

克隆仓库并运行npm install安装项目依赖。

配置环境变量

编辑.env文件并填写Shopify API密钥及访问令牌。

启动服务器

运行npm start开始监听订单操作。

使用案例

查询订单详情通过get-order-details命令获取订单#1001的信息。

批量发货使用request-fulfillment命令处理多个未完成订单。

常见问题

是否需要额外付费才能使用Shopify MCP服务器？

如何确保API版本兼容性？

是否支持敏感数据操作？

🚀 Shopify MCP 服务器

Shopify MCP 服务器是一个基于 Model Context Protocol (MCP) 的工具，它能将 Shopify 运营与 LLM 代理完美集成。借助该服务器，你可以轻松处理 Shopify 订单，涵盖履行订单、添加跟踪信息、存档以及检索订单等功能。

🚀 快速开始

本服务器可助力你高效处理 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
```

💻 使用示例

基础用法

此服务器实现 Model Context Protocol (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，当您提供友好格式的订单号时。

更新跟踪信息

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

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

使用 add-tracking 工具并提供履行 ID 和跟踪信息：

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