WooCommerce管理服务器

mcp服务器woocommerce

MCP服务器，用于通过Claude等人工智能助手管理WooCommerce商店。提供101个工具，涵盖产品、订单、客户、优惠券、运费、税费、webhooks、设置、报告等。

快速开始

1.获取WooCommerce API密钥

在您的WordPress管理员中： WooCommerce>设置>高级>REST API>添加密钥 具有读/写权限。

2.添加到您的AI工具

无需安装--直接通过运行 npx:

{
  "mcpServers": {
    "woocommerce": {
      "command": "npx",
      "args": ["-y", "@amitgurbani/mcp-server-woocommerce"],
      "env": {
        "WORDPRESS_SITE_URL": "https://store.example.com",
        "WOOCOMMERCE_CONSUMER_KEY": "ck_your_key",
        "WOOCOMMERCE_CONSUMER_SECRET": "cs_your_secret"
      }
    }
  }
}

{
  "mcpServers": {
    "woocommerce": {
      "command": "npx",
      "args": ["-y", "@amitgurbani/mcp-server-woocommerce"],
      "env": {
        "WORDPRESS_SITE_URL": "https://store.example.com",
        "WOOCOMMERCE_CONSUMER_KEY": "ck_your_key",
        "WOOCOMMERCE_CONSUMER_SECRET": "cs_your_secret"
      }
    }
  }
}

{
  "mcpServers": {
    "woocommerce": {
      "command": "npx",
      "args": ["-y", "@amitgurbani/mcp-server-woocommerce"],
      "env": {
        "WORDPRESS_SITE_URL": "https://store.example.com",
        "WOOCOMMERCE_CONSUMER_KEY": "ck_your_key",
        "WOOCOMMERCE_CONSUMER_SECRET": "cs_your_secret"
      }
    }
  }
}

4.开始使用它 --问你的AI助手一些事情，比如：

“列出所有缺货的产品” “订单满$50可创建10%折扣券” “给我看看本周的销售报告”

特性

• 全店管理 --产品、类别、标签、品牌、订单、客户和优惠券的CRUD操作
• 产品分类 --具有批处理支持的属性、属性术语和变体
• 运输 --区域、区域方法和运输类别
• 税收 --税率和税种
• 网络钩子 --创建、管理和监视webhook订阅
• 设置 --读取并更新存储配置
• 报告 --销售报告、畅销商品、订单/产品/客户总数
• 媒体管理 -通过WordPress REST API列出、删除和清除孤立媒体
• 令牌优化 --所有工具都支持a fields param仅返回特定字段，将响应大小减少60-97%
• MCP资源 --代理可以读取产品、订单、优惠券、退款和支付网关的模式引用以获取上下文
• 引导式提示 --用于可变产品设置、订单处理和目录概述的多步骤工作流
• 工具注释 — readOnlyHint, destructiveHint，以及 idempotentHint 关于安全代理行为的101个工具
• 可操作的错误 --错误响应包括如何解决常见问题的指导

安全

此服务器连接到LIVE WooCommerce商店。 每次创建、更新和删除操作都会影响真实数据。小心，尤其是在生产商店。

开始之前

• 备份您的店铺 在使用破坏性工具之前。使用WordPress备份插件或主机的备份功能。
• 先进行分期测试。 将生产存储克隆到临时环境，并将此服务器指向临时URL。
• 使用只读模式 探索时。设置 WOOCOMMERCE_MCP_READ_ONLY=true 要阻止所有写入操作，只有列表、获取和报告工具可以工作。

不可逆操作

大多数删除操作都会将项目移动到回收站（可恢复）。然而，这些是 永久且无法撤销:

级联效应

某些操作影响的不仅仅是正在更改的单个项目：

• 删除属性 从所有产品中删除它——可变产品可能会损坏
• 删除属性项 从所有产品和变体中删除该选项
• 删除运输区域 删除该区域中的所有方法和位置
• 批量操作 (batch_update_attribute_terms, batch_update_variations)可以在一次调用中创建、更新和删除

API密钥权限

为了最大限度的安全，请仅使用您需要的权限创建WooCommerce API密钥：

• 只读探索：使用创建密钥 阅读 仅限权限
• 管理：使用 读写权限 权限

可用工具（101）

资源

服务器公开了7个MCP资源，为AI代理提供模式参考和指南：

资源是只读上下文，代理可以在进行API调用之前获取该上下文以理解WooCommerce数据结构。

提示

5个指导性工作流程提示，协调多步骤操作：

工具注释

每个工具都带有行为提示，因此AI代理可以做出安全的决策：

所有工具也已设置 openWorldHint: false --它们只与WooCommerce相互作用，没有外部副作用。

配置

环境变量

使用a .env 文件

不要内联凭据，而是指向一个带有 .env 文件：

{
  "mcpServers": {
    "woocommerce": {
      "command": "npx",
      "args": ["-y", "@amitgurbani/mcp-server-woocommerce"],
      "cwd": "/path/to/your/project"
    }
  }
}

多家店铺

使用不同的服务器名称从一个项目管理多个商店：

{
  "mcpServers": {
    "store-a": {
      "command": "npx",
      "args": ["-y", "@amitgurbani/mcp-server-woocommerce"],
      "env": { "WORDPRESS_SITE_URL": "https://store-a.com", "..." }
    },
    "store-b": {
      "command": "npx",
      "args": ["-y", "@amitgurbani/mcp-server-woocommerce"],
      "env": { "WORDPRESS_SITE_URL": "https://store-b.com", "..." }
    }
  }
}

令牌优化

所有工具都支持可选 fields param（逗号分隔）仅返回特定字段：

# Browsing products — just names and prices
fields: "id,name,price"

# Stock check
fields: "id,name,stock_status,stock_quantity"

# Order overview
fields: "id,number,status,total"

这减少了响应大小 60-97%，保持人工智能上下文窗口的焦点和低成本。

发展

git clone https://github.com/AmitGurbani/mcp-server-woocommerce.git
cd mcp-server-woocommerce
pnpm install

pnpm dev               # Watch mode
pnpm build             # Build
pnpm start             # Run directly
pnpm test              # Run unit tests
pnpm test:integration  # Run integration tests (requires Docker)
pnpm test:watch        # Run unit tests in watch mode
pnpm inspector         # Debug with MCP Inspector

集成测试 通过以下方式在真实的WordPress 6.9.4+WooCommerce 10.5.3实例上运行 @wordpress/env先决条件：Docker。运行时，测试环境会自动启动 pnpm test:integration.

码头工人

docker build -t mcp-server-woocommerce .
docker run \
  -e WORDPRESS_SITE_URL=https://store.example.com \
  -e WOOCOMMERCE_CONSUMER_KEY=ck_your_key \
  -e WOOCOMMERCE_CONSUMER_SECRET=cs_your_secret \
  mcp-server-woocommerce

远程/移动访问（HTTP传输）

要从Claude mobile、ChatGPT或其他远程客户端访问WooCommerce工具，请在HTTP模式下运行服务器：

MCP_TRANSPORT=http MCP_AUTH_TOKEN=your-secret-token node build/index.js

或者使用Docker：

docker run -p 3000:3000 \
  -e MCP_TRANSPORT=http \
  -e MCP_AUTH_TOKEN=your-secret-token \
  -e WORDPRESS_SITE_URL=https://store.example.com \
  -e WOOCOMMERCE_CONSUMER_KEY=ck_your_key \
  -e WOOCOMMERCE_CONSUMER_SECRET=cs_your_secret \
  mcp-server-woocommerce

要么 MCP_AUTH_TOKEN 或 AUTH0_DOMAIN + AUTH0_AUDIENCE + MCP_SERVER_URL 是必需的。

部署指南：参见 文档/部署.md 有关Railway（~$0/mo）、Fly.io（~$0/1mo，扩展到零）和Docker部署的分步说明。

克劳德桌面/代码：使用承载令牌身份验证--添加服务器URL和 Authorization: Bearer <token> 标题指向您的配置。

Claude.ai网络/移动：需要通过Auth0（免费层）使用OAuth 2.1。看 部署指南 有关设置说明。

默认模式保持不变 stdio --现有 npx 用户不受影响。

许可证

麻省理工学院

WooCommerce是Automattic股份有限公司的注册商标。本项目不隶属于Automattic股份有限公司，也不由其背书或赞助。