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
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/pluginslab/ms-woocommerce-mcp-assistant/archive/refs/heads/main.zip
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