AI导哈

WooCommerce REST API 管理工具

一个为WooCommerce REST API提供73个生产级工具的综合管理服务器，覆盖产品、订单、客户、库存、报告等全功能CRUD操作。

  • by AlexlaGuardia
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 AlexlaGuardia/MCP-WooCommerce

使用说明

mcp woocommerce

生产级MCP服务器 WooCommerce REST API --73个工具，用于产品、变体、属性、订单、客户、优惠券、评论、报告、运输、付款、webhooks、批处理操作、库存和系统管理。

为什么存在

WooCommerce的实力 36%的电子商务 （500多万活跃商店），但没有全面的MCP服务器。这就用73个可用于生产的工具填补了这一空白，这些工具涵盖了整个WooCommerce REST API v3，每个核心资源都有完整的CRUD。

特性

  • 73工具 涵盖18个类别——最全面的WooCommerce MCP服务器
  • 完整CRUD 用于产品、变体、属性、属性术语、类别、标签、评论、订单、客户、优惠券和Webhook
  • 库存管理 --列出缺货和低库存产品
  • 批量操作 --在一次通话中批量更新产品和订单
  • 报告和分析 --销售报告、畅销商品、订单/产品总计
  • 存储配置 --设置、税务类别、运输类别、货币、国家
  • Webhook管理 --为实时事件创建、更新、列出、删除webhook
  • 系统诊断 --WooCommerce/WordPress版本、插件、服务器环境
  • 错误安全 --每一个包含错误处理的工具都不会在API失败时崩溃
  • 简单身份验证 --通过环境变量提供消费者密钥+密钥

快速开始

安装

pip install mcp-woocommerce

配置

将WooCommerce REST API凭据设置为环境变量：

export WOOCOMMERCE_URL="https://yourstore.com"
export WOOCOMMERCE_KEY="ck_your_consumer_key"
export WOOCOMMERCE_SECRET="cs_your_consumer_secret"

在以下位置生成API密钥： WordPress管理>WooCommerce>设置>高级>REST API

跑

mcp-woocommerce

或者作为模块运行：

python -m mcp_woocommerce

与Claude Desktop一起使用

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "woocommerce": {
      "command": "mcp-woocommerce",
      "env": {
        "WOOCOMMERCE_URL": "https://yourstore.com",
        "WOOCOMMERCE_KEY": "ck_your_consumer_key",
        "WOOCOMMERCE_SECRET": "cs_your_consumer_secret"
      }
    }
  }
}

与Claude Code一起使用

claude mcp add woocommerce -- mcp-woocommerce

然后在运行Claude Code之前在shell中设置环境变量。

工具（73）

商店（1）

工具 说明
ping 验证连接并获取店铺信息

产品（8）

工具 说明
list_products 列出带有过滤器的产品（状态、类别、搜索、在线销售）
get_product 完整的产品详细信息（定价、库存、图片、属性）
create_product 创建产品（简单、可变、分组、外部）
update_product 更新产品字段（价格、库存、状态等）
delete_product 删除或丢弃产品
search_products 按名称或SKU搜索
list_low_stock_products 按库存状态列出产品（缺货、延期交货）

产品分类（4）

工具 说明
list_product_categories 列出具有层次结构的类别
create_product_category 创建一个类别（子类别可选父类别）
update_product_category 更新类别名称、描述、slug、父级
delete_product_category 删除类别

产品变化（5）

工具 说明
list_product_variations 列出可变产品的所有变体
get_product_variation 完整的变化细节（定价、库存、属性）
create_product_variation 创建具有属性和定价的变体
update_product_variation 更新变动价格、库存、状态
delete_product_variation 删除变体

产品属性（5）

工具 说明
list_product_attributes 列出所有属性（例如颜色、大小）
get_product_attribute 获取属性详细信息及其术语
create_product_attribute 创建属性（选择或文本类型）
update_product_attribute 更新属性名称、slug、排序
delete_product_attribute 从所有产品中删除属性

属性术语（4）

工具 说明
list_attribute_terms 列出属性的术语（例如，红色、蓝色表示颜色）
create_attribute_term 向属性添加术语
update_attribute_term 更新术语的名称、符号、描述
delete_attribute_term 删除术语

产品标签（3）

工具 说明
list_product_tags 列出带有可选搜索的标签
create_product_tag 创建产品标签
delete_product_tag 删除产品标签

产品评论（4）

工具 说明
list_product_reviews 列出评论（按产品或状态筛选）
get_product_review 完整的审核详细信息
create_product_review 创建带有评分的评论
delete_product_review 删除评论

订单（10）

工具 说明
list_orders 列出带有过滤器的订单（状态、客户、日期范围）
get_order 完整的订单详细信息（项目、账单、运费、付款）
create_order 使用行项目创建订单
update_order_status 更改订单状态（待定、正在处理、已完成等）
update_order 编辑订单账单/送货地址和客户备注
delete_order 删除或废弃订单
list_order_notes 获取订单上的所有笔记
create_order_note 添加面向员工或客户的备注
create_refund 退款
list_refunds 列出订单的所有退款

客户（6）

工具 说明
list_customers 使用筛选器（角色、搜索）列出客户
get_customer 完整的客户详细信息，包括地址和订单统计数据
create_customer 创建新客户
update_customer 更新客户信息、账单/送货地址
delete_customer 删除客户（可选择重新分配订单）
search_customers 按姓名或电子邮件搜索

优惠券（5）

工具 说明
list_coupons 通过搜索列出优惠券
get_coupon 完整的优惠券详细信息（限制、限制、使用）
create_coupon 创建百分比、固定购物车或固定产品优惠券
update_coupon 更新优惠券金额、到期日、限额等。
delete_coupon 删除优惠券

报告（4）

工具 说明
get_sales_report 按期间（周、月、年、自定义范围）划分的销售总额
get_top_sellers 按时期划分的畅销产品
get_order_totals 按状态列出的订单数量
get_product_totals 按类型统计的产品数量

设置（1）

工具 说明
get_store_settings 按组读取商店设置（一般、产品、税务等）

运输和付款（5）

工具 说明
list_shipping_zones 航运区及其方法
list_payment_gateways 处于启用状态的支付网关
list_tax_rates 所有配置的税率
list_tax_classes 税种（标准、减税、零税率）
list_shipping_classes 产品运输类别

Webhooks（4）

工具 说明
list_webhooks 列出所有Webhook
create_webhook 为订单/产品/客户事件创建webhooks
update_webhook 更新webhook URL、主题、状态
delete_webhook 删除webhook

批量操作（2）

工具 说明
batch_update_products 在一次通话中批量更新多个产品
batch_update_orders 在一次通话中批量更新多个订单

数据（2）

工具 说明
list_currencies 所有支持的带有代码和符号的货币
list_countries 所有有州/省的国家

系统（1）

工具 说明
get_system_status WooCommerce/WordPress版本、插件、服务器环境

认证

WooCommerce使用 消费者密钥+消费者秘密 用于REST API验证。此服务器使用HTTPS上的HTTP基本身份验证。

  1. 首选 WordPress管理>WooCommerce>设置>高级>REST API
  2. 点击 添加键
  3. 将权限设置为 读写权限
  4. 复制消费者密钥(ck_...)消费者秘密(cs_...)

重要提示： 您的商店必须使用HTTPS进行基本身份验证才能安全工作。

需求

  • Python 3.10+
  • WooCommerce 3.5+与REST API v3
  • 您的商店已启用HTTPS

许可证

麻省理工学院

相关 MCP