MCP 服务器

shopify-mcp

Okay, here's a translation of "for Shopify API interaction including product, customer, order" into Chinese, along with some nuances and options depending on the specific context: **Option 1 (Most General):** * **中文:** 用于 Shopify API 交互，包括产品、客户和订单。 * **Pinyin:** Yòng yú Shopify API jiāohù, bāokuò chǎnpǐn, kèhù hé dìngdān. * **Explanation:** This is a straightforward and common translation. It's suitable for general documentation or explanations. **Option 2 (More Emphasis on "Handling" or "Working With"):** * **中文:** 用于 Shopify API 交互，处理产品、客户和订单。 * **Pinyin:** Yòng yú Shopify API jiāohù, chǔlǐ chǎnpǐn, kèhù hé dìngdān. * **Explanation:** The word "处理 (chǔlǐ)" means "to handle," "to process," or "to deal with." This option is better if you want to emphasize the actions you're taking with the data. **Option 3 (More Technical, Emphasizing Data Manipulation):** * **中文:** 用于 Shopify API 交互，涉及产品、客户和订单的数据操作。 * **Pinyin:** Yòng yú Shopify API jiāohù, shèjí chǎnpǐn, kèhù hé dìngdān de shùjù cāozuò. * **Explanation:** This is a more technical translation. "涉及 (shèjí)" means "involving" or "relating to," and "数据操作 (shùjù cāozuò)" means "data manipulation." This is suitable for technical documentation or code comments. **Option 4 (More Specific to Development):** * **中文:** 用于 Shopify API 交互，开发产品、客户和订单相关功能。 * **Pinyin:** Yòng yú Shopify API jiāohù, kāifā chǎnpǐn, kèhù hé dìngdān xiāngguān gōngnéng. * **Explanation:** This option is suitable if you are talking about developing features related to product, customer and order. "开发 (kāifā)" means "to develop", and "相关功能 (xiāngguān gōngnéng)" means "related features". **Key Vocabulary:** * **Shopify API:** Shopify API (No translation needed, commonly used as is) * **交互 (jiāohù):** Interaction * **产品 (chǎnpǐn):** Product * **客户 (kèhù):** Customer * **订单 (dìngdān):** Order * **用于 (yòng yú):** Used for * **包括 (bāokuò):** Including * **处理 (chǔlǐ):** To handle, to process, to deal with * **涉及 (shèjí):** Involving, relating to * **数据操作 (shùjù cāozuò):** Data manipulation * **开发 (kāifā):** To develop * **相关功能 (xiāngguān gōngnéng):** Related features **Which option is best?** The best option depends on the context. If you're writing general documentation, Option 1 is a good choice. If you're describing the actions you're taking, Option 2 is better. If you're writing technical documentation, Option 3 might be more appropriate. If you are talking about development, Option 4 is a good choice. I hope this helps! Let me know if you have any other questions.

Tools

get-products

get-product-by-id

get-customers

get-orders

update-order

README

Shopify MCP 服务器

(如果您喜欢，请留下一个星星！)

用于 Shopify API 的 MCP 服务器，可以通过 GraphQL API 与商店数据进行交互。此服务器提供用于管理产品、客户、订单等的工具。

功能

产品管理: 搜索和检索产品信息
客户管理: 加载客户数据和管理客户标签
订单管理: 高级订单查询和过滤
GraphQL 集成: 与 Shopify 的 GraphQL Admin API 直接集成
全面的错误处理: 针对 API 和身份验证问题的清晰错误消息

前提条件

Node.js (版本 16 或更高)
Shopify 自定义应用访问令牌 (请参阅下面的设置说明)

设置

Shopify 访问令牌

要使用此 MCP 服务器，您需要在 Shopify 商店中创建一个自定义应用：

在 Shopify 管理后台中，转到设置 > 应用和销售渠道
点击 开发应用 (您可能需要先启用开发者预览)
点击 创建应用
为您的应用设置一个名称 (例如，"Shopify MCP Server")
点击 配置 Admin API 范围
选择以下范围：
- read_products, write_products
- read_customers, write_customers
- read_orders, write_orders
点击保存
点击 安装应用
点击安装以授予应用访问您的商店数据的权限
安装完成后，您将看到您的 Admin API 访问令牌
复制此令牌 - 您将需要它进行配置

与 Claude Desktop 一起使用

将其添加到您的 claude_desktop_config.json：

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": [
        "shopify-mcp",
        "--accessToken",
        "<YOUR_ACCESS_TOKEN>",
        "--domain",
        "<YOUR_SHOP>.myshopify.com"
      ]
    }
  }
}

Claude Desktop 配置文件位置：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

替代方案：使用环境变量在本地运行

如果您更喜欢使用环境变量而不是命令行参数：

创建一个包含您的 Shopify 凭据的 .env 文件：

SHOPIFY_ACCESS_TOKEN=your_access_token
MYSHOPIFY_DOMAIN=your-store.myshopify.com

使用 npx 运行服务器：
```
npx shopify-mcp-server
```

直接安装 (可选)

如果您想全局安装该软件包：

npm install -g shopify-mcp-server

然后运行它：

shopify-mcp-server --accessToken=<YOUR_ACCESS_TOKEN> --domain=<YOUR_SHOP>.myshopify.com

可用工具

产品管理

get-products
- 获取所有产品或按标题搜索
- 输入：
  - searchTitle (可选字符串): 按标题过滤产品
  - limit (数字): 要返回的最大产品数量
get-product-by-id
- 按 ID 获取特定产品
- 输入：
  - productId (字符串): 要检索的产品的 ID

客户管理

get-customers
- 获取客户或按姓名/电子邮件搜索
- 输入：
  - searchQuery (可选字符串): 按姓名或电子邮件过滤客户
  - limit (可选数字, 默认: 10): 要返回的最大客户数量
update-customer
- 更新客户的信息
- 输入：
  - id (字符串, 必需): Shopify 客户 ID (仅限数字 ID, 例如 "6276879810626")
  - firstName (字符串, 可选): 客户的名字
  - lastName (字符串, 可选): 客户的姓氏
  - email (字符串, 可选): 客户的电子邮件地址
  - phone (字符串, 可选): 客户的电话号码
  - tags (字符串数组, 可选): 要应用于客户的标签
  - note (字符串, 可选): 关于客户的备注
  - taxExempt (布尔值, 可选): 客户是否免税
  - metafields (对象数组, 可选): 用于存储其他数据的客户元字段
get-customer-orders
- 获取特定客户的订单
- 输入：
  - customerId (字符串, 必需): Shopify 客户 ID (仅限数字 ID, 例如 "6276879810626")
  - limit (可选数字, 默认: 10): 要返回的最大订单数量

订单管理

get-orders
- 获取订单，并可选择过滤
- 输入：
  - status (可选字符串): 按订单状态过滤
  - limit (可选数字, 默认: 10): 要返回的最大订单数量
update-order
- 使用新信息更新现有订单
- 输入：
  - id (字符串, 必需): Shopify 订单 ID
  - tags (字符串数组, 可选): 订单的新标签
  - email (字符串, 可选): 更新客户电子邮件
  - note (字符串, 可选): 订单备注
  - customAttributes (对象数组, 可选): 订单的自定义属性
  - metafields (对象数组, 可选): 订单元字段
  - shippingAddress (对象, 可选): 运送地址信息

调试

如果遇到问题，请检查 Claude Desktop 的 MCP 日志：

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

许可证

MIT