woocommerce-mcp

woocommerce-mcp

一个小型、只读的 Model Context Protocol 服务，适用于 WordPress + WooCommerce。它通过官方 REST API，让 Claude（或任何 MCP 客户端）查询线上商店的信息，包括商品、订单、销售数据和博客文章。不会执行写入操作，也无需在商店安装插件：它直接连接现有的 WordPress/WooCommerce REST 端点。

由 WPPoland 开发并维护。WPPoland 是一家自 2006 年起从事 WordPress 项目的资深 WordPress 开发商。如果你需要将它接入实际的商店技术栈，我们提供 WooCommerce ERP 和 API 集成以及企业级电子商务架构（无头架构、集成、AI 就绪数据）。

工具

工具	功能	需要 WooCommerce 密钥
list_products	列出／搜索商品（名称、sku、价格、库存、永久链接）	是
get_product	根据 id 获取单个商品的完整详情	是
list_orders	按时间从新到旧列出近期订单，可选状态筛选	是
sales_report	获取指定时期的销售总额（week / month / last_month / year）	是
search_posts	搜索已发布的博客文章（公开的 WP REST API）	否

所有操作均为只读。该服务不会在商店中创建、编辑或删除任何内容。

安装和构建

从 npm 安装（包名使用命名空间；未加命名空间的 woocommerce-mcp 名称已在注册表中被占用）：

npm install -g @wppoland/woocommerce-mcp
# or: npx @wppoland/woocommerce-mcp

从源代码构建：

git clone https://github.com/wppoland/woocommerce-mcp.git
cd woocommerce-mcp
npm install
npm run build

配置

设置三个环境变量：

变量	必需	示例
WP_URL	是	https://shop.example.com
WC_CONSUMER_KEY	wc_* 工具需要	ck_xxx
WC_CONSUMER_SECRET	wc_* 工具需要	cs_xxx

在 WooCommerce → Settings → Advanced → REST API → Add key 中创建 WooCommerce 密钥，并授予 Read 权限。search_posts 无需密钥即可用于任何公开的 WordPress 网站。

密钥会通过 HTTPS 以 REST 查询身份验证的方式发送到你自己的商店。请使用 HTTPS，并且只为密钥授予 Read 访问权限。

在 Claude Desktop / Claude Code 中使用

将以下内容添加到 MCP 客户端配置中（例如 claude_desktop_config.json）：

{
  "mcpServers": {
    "woocommerce": {
      "command": "node",
      "args": ["/absolute/path/to/woocommerce-mcp/dist/index.js"],
      "env": {
        "WP_URL": "https://shop.example.com",
        "WC_CONSUMER_KEY": "ck_xxx",
        "WC_CONSUMER_SECRET": "cs_xxx"
      }
    }
  }
}

然后可以询问诸如 “上个月 WooCommerce 的销售额是多少？” 或 “列出最近 5 个处于保留状态的订单。” 等问题。

wppoland.com 上的文档

• WooCommerce MCP 开源（只读）：发布与运维指南 - npm 命名空间、注册表、Glama，以及如何在不提供写入工具的情况下发布更新

文章（站外）

发表于 DEV 的经验分享（并非 wppoland.com 页面内容的重复）：

• 面向 WooCommerce 的只读 MCP 服务：AI Agent 实际需要从商店获取什么
• 将批发商的 API 同步到 WooCommerce，同时避免超卖或服务器过载
• 将 wppoland.com 从 WordPress 迁移到 Cloudflare Pages 上的 Astro，一年之后

Show HN：讨论

验证

npm run check   # builds, then asserts all five tools register (no network/credentials needed)

说明

• Node 18+（使用内置的 fetch）。
• 日志写入 stderr，不会破坏 stdout 上的 stdio MCP 协议。
• API 错误会显示商店返回的信息；绝不会回显凭据。

许可证

MIT © WPPoland