Servidor MCP de WooCommerce

Un servidor de Protocolo de contexto de modelo (MCP) para la integración de WooCommerce, compatible con Windows, macOS y Linux.

Descripción general

Este servidor MCP permite la interacción con tiendas WooCommerce a través de la API REST de WordPress. Proporciona herramientas integrales para gestionar todos los aspectos de productos, pedidos, clientes, envíos, impuestos, descuentos y configuración de la tienda mediante el protocolo JSON-RPC 2.0.

Instalación

Clonar el repositorio
Instalar dependencias:

npm install

Construir el proyecto:

npm run build

Configuración

Agregue el servidor a su archivo de configuración de MCP con variables de entorno para las credenciales:

{ "mcpServers": { "woocommerce": { "command": "node", "args": ["path/to/build/index.js"], "env": { "WORDPRESS_SITE_URL": "https://your-wordpress-site.com", "WOOCOMMERCE_CONSUMER_KEY": "your-woocommerce-consumer-key", "WOOCOMMERCE_CONSUMER_SECRET": "your-woocommerce-consumer-secret", "WORDPRESS_USERNAME": "your-wordpress-username", "WORDPRESS_PASSWORD": "your-wordpress-password" } } } }

Variables de entorno

Necesario para acceder a la API de WooCommerce:

WORDPRESS_SITE_URL : URL de su sitio de WordPress (WooCommerce es un complemento de WordPress)
WOOCOMMERCE_CONSUMER_KEY : Clave de consumidor de la API REST de WooCommerce
WOOCOMMERCE_CONSUMER_SECRET : Secreto del consumidor de la API REST de WooCommerce

Requerido solo para los métodos de API de WordPress:

WORDPRESS_USERNAME : Nombre de usuario de WordPress con los permisos adecuados
WORDPRESS_PASSWORD : Contraseña de WordPress para autenticación

También puede proporcionar estas credenciales en los parámetros de solicitud si prefiere no utilizar variables de entorno.

Opciones de autenticación

Autenticación de WooCommerce

El acceso a la API de WooCommerce requiere claves de consumidor que puedes generar en tu panel de WordPress en WooCommerce → Configuración → Avanzado → API REST.

Autenticación de WordPress

Para los métodos específicos de WordPress (como administrar publicaciones), debes proporcionar:

Credenciales de usuario/contraseña para autenticación básica
La API REST de WordPress debe estar habilitada en su sitio

Métodos API

El servidor admite los métodos de la API de WordPress y WooCommerce. A continuación, se muestra una lista de los métodos disponibles, agrupados por categoría:

Gestión de contenido de WordPress

Estos métodos requieren credenciales de nombre de usuario y contraseña de WordPress y son independientes de la API de WooCommerce.

Método	Descripción
`create_post`	Crear una nueva publicación en WordPress
`get_posts`	Recuperar publicaciones de WordPress
`update_post`	Actualizar una publicación existente de WordPress
`get_post_meta`	Obtener metadatos de la publicación
`update_post_meta`	Actualizar metadatos de la publicación
`create_post_meta`	Crear metadatos de publicaciones
`delete_post_meta`	Eliminar metadatos de la publicación

Productos WooCommerce

Método	Descripción
`get_products`	Recuperar una lista de productos
`get_product`	Obtenga un solo producto por ID
`create_product`	Crear un nuevo producto
`update_product`	Actualizar un producto existente
`delete_product`	Eliminar un producto
`get_product_meta`	Obtener metadatos del producto
`create_product_meta`	Crear/actualizar metadatos del producto
`update_product_meta`	Actualizar metadatos del producto (alias para crear)
`delete_product_meta`	Eliminar metadatos del producto

Categorías de productos

Método	Descripción
`get_product_categories`	Recuperar categorías de productos
`get_product_category`	Obtenga una única categoría de producto
`create_product_category`	Crear una nueva categoría de producto
`update_product_category`	Actualizar una categoría de producto
`delete_product_category`	Eliminar una categoría de producto

Etiquetas de productos

Método	Descripción
`get_product_tags`	Recuperar etiquetas de productos
`get_product_tag`	Obtenga una sola etiqueta de producto
`create_product_tag`	Crear una nueva etiqueta de producto
`update_product_tag`	Actualizar una etiqueta de producto
`delete_product_tag`	Eliminar una etiqueta de producto

Atributos del producto

Método	Descripción
`get_product_attributes`	Recuperar atributos del producto
`get_product_attribute`	Obtener un único atributo del producto
`create_product_attribute`	Crear un nuevo atributo de producto
`update_product_attribute`	Actualizar un atributo de producto
`delete_product_attribute`	Eliminar un atributo de producto
`get_attribute_terms`	Recuperar términos de atributos
`get_attribute_term`	Obtener un único término de atributo
`create_attribute_term`	Crear un nuevo término de atributo
`update_attribute_term`	Actualizar un término de atributo
`delete_attribute_term`	Eliminar un término de atributo

Variaciones del producto

Método	Descripción
`get_product_variations`	Recuperar variaciones de producto
`get_product_variation`	Obtenga una única variación del producto
`create_product_variation`	Crear una nueva variación de producto
`update_product_variation`	Actualizar una variación de producto
`delete_product_variation`	Eliminar una variación de producto

Reseñas de productos

Método	Descripción
`get_product_reviews`	Recuperar reseñas de productos
`get_product_review`	Obtenga una reseña de un solo producto
`create_product_review`	Crear una nueva reseña de producto
`update_product_review`	Actualizar una reseña de un producto
`delete_product_review`	Eliminar una reseña de un producto

Pedidos de WooCommerce

Método	Descripción
`get_orders`	Recuperar una lista de pedidos
`get_order`	Obtenga un pedido único por ID
`create_order`	Crear un nuevo pedido
`update_order`	Actualizar un pedido existente
`delete_order`	Eliminar un pedido
`get_order_meta`	Obtener metadatos del pedido
`create_order_meta`	Crear/actualizar metadatos de pedidos
`update_order_meta`	Actualizar metadatos de la orden (alias para crear)
`delete_order_meta`	Eliminar metadatos de pedidos

Notas del pedido

Método	Descripción
`get_order_notes`	Recuperar notas de pedidos
`get_order_note`	Obtener una nota de pedido única
`create_order_note`	Crear una nueva nota de pedido
`delete_order_note`	Eliminar una nota de pedido

Reembolsos de pedidos

Método	Descripción
`get_order_refunds`	Recuperar reembolsos de pedidos
`get_order_refund`	Obtenga un reembolso de un solo pedido
`create_order_refund`	Crear un nuevo reembolso de pedido
`delete_order_refund`	Eliminar un reembolso de pedido

Clientes de WooCommerce

Método	Descripción
`get_customers`	Recuperar una lista de clientes
`get_customer`	Obtener un solo cliente por ID
`create_customer`	Crear un nuevo cliente
`update_customer`	Actualizar un cliente existente
`delete_customer`	Eliminar un cliente
`get_customer_meta`	Obtener metadatos del cliente
`create_customer_meta`	Crear/actualizar metadatos del cliente
`update_customer_meta`	Actualizar metadatos del cliente (alias para crear)
`delete_customer_meta`	Eliminar metadatos del cliente

Envío

Método	Descripción
`get_shipping_zones`	Recuperar zonas de envío
`get_shipping_zone`	Obtenga una única zona de envío
`create_shipping_zone`	Crear una nueva zona de envío
`update_shipping_zone`	Actualizar una zona de envío
`delete_shipping_zone`	Eliminar una zona de envío
`get_shipping_methods`	Recuperar métodos de envío
`get_shipping_zone_methods`	Obtener métodos de envío para una zona
`create_shipping_zone_method`	Crear un nuevo método de envío para una zona
`update_shipping_zone_method`	Actualizar un método de envío para una zona
`delete_shipping_zone_method`	Eliminar un método de envío de una zona
`get_shipping_zone_locations`	Obtener ubicaciones para una zona de envío
`update_shipping_zone_locations`	Actualizar ubicaciones para una zona de envío

Impuestos

Método	Descripción
`get_tax_classes`	Recuperar clases de impuestos
`create_tax_class`	Crear una nueva clase de impuesto
`delete_tax_class`	Eliminar una clase de impuesto
`get_tax_rates`	Recuperar tasas de impuestos
`get_tax_rate`	Obtener una tasa impositiva única
`create_tax_rate`	Crear una nueva tasa impositiva
`update_tax_rate`	Actualizar una tasa impositiva
`delete_tax_rate`	Eliminar una tasa impositiva

Descuentos/Cupones

Método	Descripción
`get_coupons`	Recuperar cupones
`get_coupon`	Obtenga un solo cupón
`create_coupon`	Crear un nuevo cupón
`update_coupon`	Actualizar un cupón
`delete_coupon`	Eliminar un cupón

Pasarelas de pago

Método	Descripción
`get_payment_gateways`	Recuperar pasarelas de pago
`get_payment_gateway`	Obtenga una única pasarela de pago
`update_payment_gateway`	Actualizar una pasarela de pago

Informes

Método	Descripción
`get_sales_report`	Recuperar informes de ventas
`get_products_report`	Recuperar informes de productos
`get_orders_report`	Recuperar informes de pedidos
`get_categories_report`	Recuperar informes de categorías
`get_customers_report`	Recuperar informes de clientes
`get_stock_report`	Recuperar informes de stock
`get_coupons_report`	Recuperar informes de cupones
`get_taxes_report`	Recuperar informes de impuestos

Ajustes

Método	Descripción
`get_settings`	Recuperar todas las configuraciones
`get_setting_options`	Recuperar opciones para una configuración
`update_setting_option`	Actualizar una opción de configuración

Estado del sistema

Método	Descripción
`get_system_status`	Recuperar el estado del sistema
`get_system_status_tools`	Recuperar herramientas de estado del sistema
`run_system_status_tool`	Ejecutar una herramienta de estado del sistema

Datos

Método	Descripción
`get_data`	Recuperar datos de la tienda
`get_continents`	Recuperar datos de los continentes
`get_countries`	Recuperar datos de países
`get_currencies`	Recuperar datos de divisas
`get_current_currency`	Obtenga la moneda actual

Parámetros del método

Todos los métodos siguen una estructura de parámetros similar. A continuación, se muestran algunos ejemplos:

Parámetros comunes para todos los métodos

siteUrl : (opcional si se configura en env) URL del sitio de WordPress

Parámetros adicionales para los métodos de WooCommerce

consumerKey : (opcional si se configura en env) Clave de consumidor de WooCommerce
consumerSecret : (opcional si se configura en env) Secreto del consumidor de WooCommerce

Parámetros adicionales para los métodos de WordPress

username : (opcional si se configura en el entorno) nombre de usuario de WordPress
password : (opcional si se configura en el entorno) Contraseña de WordPress

Ejemplo de uso

Ejemplo de API de WordPress

{ "jsonrpc": "2.0", "id": 1, "method": "create_post", "params": { "siteUrl": "https://your-wordpress-site.com", "username": "your-wordpress-username", "password": "your-wordpress-password", "title": "My New Blog Post", "content": "This is the content of my new blog post.", "status": "publish" } }

Ejemplo de productos de WooCommerce

{ "jsonrpc": "2.0", "id": 1, "method": "get_products", "params": { "perPage": 20, "page": 1, "filters": { "category": 19, "status": "publish" } } }

Crear ejemplo de producto

{ "jsonrpc": "2.0", "id": 1, "method": "create_product", "params": { "productData": { "name": "Premium T-Shirt", "type": "simple", "regular_price": "29.99", "description": "Comfortable cotton t-shirt, available in various sizes.", "short_description": "Premium quality t-shirt.", "categories": [ { "id": 19 } ], "images": [ { "src": "http://example.com/wp-content/uploads/2022/06/t-shirt.jpg" } ] } } }

Ejemplo de metadatos del producto

{ "jsonrpc": "2.0", "id": 1, "method": "create_product_meta", "params": { "productId": 456, "metaKey": "_custom_product_field", "metaValue": { "special_attribute": "value", "another_attribute": 42 } } }

Ejemplo de metadatos de pedido

{ "jsonrpc": "2.0", "id": 1, "method": "create_order_meta", "params": { "orderId": 789, "metaKey": "_delivery_instructions", "metaValue": "Leave package at the back door" } }

Nota de seguridad

Para acceder a la API REST de WooCommerce, necesitas generar claves API. Puedes crearlas en tu panel de WordPress, en WooCommerce → Configuración → Avanzado → API REST.

Requisitos

Node.js 20.0.0 o superior
Sitio de WordPress con el complemento WooCommerce instalado
Claves API REST de WooCommerce

Licencia

Licencia MIT: consulte el archivo LICENCIA para obtener más detalles

This server cannot be installed

security - not tested

license - not tested

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

El servidor MCP de WooCommerce permite la interacción con las tiendas WooCommerce a través de la API REST de WordPress. Proporciona herramientas integrales para gestionar todos los aspectos de productos, pedidos, clientes, envíos, impuestos, descuentos y configuración de la tienda mediante el protocolo JSON-RPC 2.0.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Server
agentico-dev
-
security
-
license
-
quality
MCP Server provides a simpler API to interact with the Model Context Protocol by allowing users to define custom tools and services to streamline workflows and processes.
Last updated -
6
3
MIT License
Shopify MCP Server
siddhantbajaj
-
security
-
license
-
quality
This MCP server connects clients with Shopify store data, enabling retrieval of product and customer information via exposed tools.
Last updated -
4
MIT License
WordPress MCP Serverofficial
Automattic
-
security
-
license
-
quality
Acts as a bridge between local MCP clients and WordPress websites, enabling communication with WordPress through simple REST API requests rather than keeping open connections.
Last updated -
774
91
MIT License
WhatsApp Business API MCP Server
ag2-mcp-servers
-
security
-
license
-
quality
An MCP (Multi-Agent Conversation Protocol) Server that enables interaction with the WhatsApp Business API, allowing agents to send messages, manage media, and perform other WhatsApp business operations through natural language.
Last updated -

View all related MCP servers