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）
产品（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基本身份验证。
- 首选 WordPress管理>WooCommerce>设置>高级>REST API
- 点击 添加键
- 将权限设置为 读写权限
- 复制消费者密钥(
ck_...)消费者秘密(cs_...)
重要提示： 您的商店必须使用HTTPS进行基本身份验证才能安全工作。
需求
- Python 3.10+
- WooCommerce 3.5+与REST API v3
- 您的商店已启用HTTPS
许可证
麻省理工学院
