Skip to main content
Glama

mcp-woocommerce

用于 WooCommerce REST API 的生产级 MCP 服务器 -- 提供 73 个工具,涵盖产品、变体、属性、订单、客户、优惠券、评论、报告、物流、支付、Webhook、批量操作、库存和系统管理。

为什么需要它

WooCommerce 为 36% 的电子商务网站(超过 500 万个活跃商店)提供支持,但目前尚无全面的 MCP 服务器。本项目填补了这一空白,提供了 73 个生产就绪的工具,涵盖了整个 WooCommerce REST API v3,并对所有核心资源提供完整的 CRUD 支持。

Related MCP server: MCP WooCommerce

功能特性

  • 73 个工具,涵盖 18 个类别 -- 目前最全面的 WooCommerce MCP 服务器

  • 完整的 CRUD:支持产品、变体、属性、属性项、分类、标签、评论、订单、客户、优惠券和 Webhook

  • 库存管理 -- 列出缺货和低库存产品

  • 批量操作 -- 在单次调用中批量更新产品和订单

  • 报告与分析 -- 销售报告、畅销产品、订单/产品总数

  • 商店配置 -- 设置、税率类别、物流类别、货币、国家/地区

  • Webhook 管理 -- 创建、更新、列出、删除用于实时事件的 Webhook

  • 系统诊断 -- WooCommerce/WordPress 版本、插件、服务器环境

  • 错误安全 -- 每个工具都封装了错误处理,不会因 API 故障而崩溃

  • 简单认证 -- 通过环境变量配置消费者密钥 (consumer key) 和密钥 (secret)

快速入门

安装

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

更新分类名称、描述、别名、父级

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

更新属性名称、别名、排序

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

为订单/产品/客户事件创建 Webhook

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 使用 消费者密钥 (consumer key) + 消费者密钥 (consumer secret) 进行 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

许可证

MIT

Install Server
A
license - permissive license
B
quality
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    -
    quality
    F
    maintenance
    WooCommerce MCP Server enables interaction with WooCommerce stores through the WordPress REST API. It provides comprehensive tools for managing all aspects of products, orders, customers, shipping, taxes, discounts, and store configuration using JSON-RPC 2.0 protocol.
    98
    MIT
  • A
    license
    -
    quality
    D
    maintenance
    An MCP server and Telegram bot that enables natural language management of WooCommerce stores, including products, orders, customers, and sales reports. It supports multiple LLM providers, voice commands via Whisper transcription, and deployment on Cloudflare Workers.
    11
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    MCP server for managing WooCommerce stores through AI assistants like Claude. Provides 101 tools covering products, orders, customers, coupons, shipping, taxes, webhooks, settings, reports, and more.
    100
    100
    1
    MIT
  • A
    license
    -
    quality
    F
    maintenance
    A comprehensive MCP server for Shopify Admin API integration, enabling AI assistants to manage products, orders, customers, inventory, analytics, and more through natural language.
    34
    18
    MIT

View all related MCP servers

Related MCP Connectors

  • Security-first WordPress MCP server. 129 tools for Claude, ChatGPT, Gemini. Free on wp.org.

  • WordPress MCP server: generate SEO posts, AI images, autoblog & WooCommerce on your self-hosted site

  • Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/AlexlaGuardia/mcp-woocommerce'

If you have feedback or need assistance with the MCP directory API, please join our Discord server