WP Manifestindependent plugin directory
manifest / ai / ms-woocommerce-mcp-assistant

Assistente MCP WooCommerce MS

Assistente de recomendações de vinhos alimentado por IA para WooCommerce usando protocolo MCP.

by Marcel Schmitz · github.com/pluginslab/ms-woocommerce-mcp-assistant

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/pluginslab/ms-woocommerce-mcp-assistant/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/pluginslab/ms-woocommerce-mcp-assistant ↗

Um plugin WordPress que adiciona um assistente de recomendações de vinhos alimentado por IA ao seu site WooCommerce, utilizando ferramentas MCP (Model Context Protocol) para interações inteligentes.

Funcionalidades

  • Assistente de Chat Inteligente: Integração com OpenAI GPT-4 para conversas naturais sobre vinhos
  • Recomendações Personalizadas: O assistente usa ferramentas MCP para buscar produtos de vinho baseados em preferências do usuário
  • Interface de Chat Flutuante: Bloco Gutenberg que adiciona um ícone de chat flutuante ao site
  • Integração WooCommerce: Busca produtos via API WooCommerce e permite adicionar ao carrinho diretamente do chat
  • Suporte a Múltiplas Línguas: Respostas em português para usuários brasileiros

Como Funciona

  1. Processamento de Linguagem Natural: O usuário descreve suas preferências de vinho (ex: "recomenda-me 2 vinhos tintos para o natal")
  2. Chamada de Ferramentas: O LLM usa function calling para executar ferramentas MCP que consultam o catálogo WooCommerce
  3. Recomendações Contextuais: Baseado nos produtos disponíveis, o assistente fornece sugestões específicas com preços e harmonizações
  4. Interação Direta: Os usuários podem adicionar produtos recomendados ao carrinho sem sair do chat

Requisitos

  • WordPress 6.8+
  • WooCommerce 10.3+
  • PHP 7.4+
  • Chave da API OpenAI
  • Credenciais da API WooCommerce (Consumer Key e Secret)

Instalação

  1. Baixe o plugin e faça upload para /wp-content/plugins/
  2. Ative o plugin através do menu 'Plugins' no WordPress
  3. Configure as chaves da API OpenAI e WooCommerce (atualmente via código ou banco de dados)
  4. Adicione o bloco "Chat Assistant" a qualquer página usando o editor Gutenberg

Configuração

As configurações são armazenadas como opções WordPress:

  • ms_openai_api_key: Sua chave da API OpenAI
  • woocommerce_consumer_key: Chave do consumidor WooCommerce
  • woocommerce_consumer_secret: Segredo do consumidor WooCommerce

Uso

  1. Adicione o bloco "Chat Assistant" à sua página
  2. O ícone de chat aparecerá no frontend
  3. Usuários podem clicar para abrir o modal de chat
  4. Digite perguntas sobre vinhos para receber recomendações

API Endpoints

  • POST /wp-json/ms-woocommerce-mcp-assistant/v1/chat: Processa mensagens de chat
  • POST /wp-json/ms-woocommerce-mcp-assistant/v1/add-to-cart: Adiciona produtos ao carrinho

Desenvolvimento

Estrutura do Plugin

  • includes/class-chat-api.php: Lida com integração OpenAI e endpoints REST
  • includes/class-custom-blocks.php: Registra blocos Gutenberg
  • includes/class-mcp-integration.php: Integração MCP (placeholder)
  • src/blocks/chat-assistant/: Componentes React para o bloco de chat

Construção

npm install
npm run build

Contribuição

Contribuições são bem-vindas! Por favor, siga os padrões de codificação WordPress.

Licença

Este plugin é distribuído sob a licença GPL v2 ou posterior.

Suporte

Para suporte, abra uma issue no repositório GitHub.

README.md