Bowlly Search

Servidor MCP Bowlly

Servidor MCP (Model Context Protocol) para busca de produtos de comida para gatos Bowlly e análise de ingredientes. Permite que o Claude Desktop busque, analise e compare produtos de comida para gatos.

Pré-requisitos

• Node.js 22+ - Necessário para executar o servidor MCP
• Claude Desktop - Baixe aqui se não estiver instalado

Início Rápido

Opção 1: Configuração em Um Comando (Recomendado)

npx @bowlly/mcp-server --setup

Após executar, reinicie o Claude Desktop e está pronto para usar!

Opção 2: Configuração Manual

1. Edite a configuração do seu Claude Desktop no caminho apropriado para o seu sistema operacional:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Adicione a configuração do servidor Bowlly:

{
  "mcpServers": {
    "bowlly": {
      "command": "npx",
      "args": ["-y", "@bowlly/mcp-server"]
    }
  }
}

3. Salve o arquivo e reinicie o Claude Desktop

Ferramentas Disponíveis

Ferramenta	Descrição
search_products	Busca por ingredientes, condições, forma
get_product_detail	Informações completas do produto com ingredientes
compare_products	Comparação lado a lado
analyze_nutrition	Detalhamento de ingredientes e análise de carboidratos
get_curation_list	Recomendações de melhores por categoria

Exemplos de Consultas em Linguagem Natural

"Find grain-free dry cat foods"
"Show me wet foods without chicken"
"Analyze the nutrition of Blue Buffalo Wilderness"
"Compare Orijen and Acana cat foods"
"What are the best low-carb options?"
"Show me foods for cats with sensitive stomachs"

Configuração

Locais dos Arquivos de Configuração por Plataforma

Plataforma	Caminho
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%/Claude/claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

Verificação

Para confirmar que o servidor MCP está funcionando:

1. Reinicie o Claude Desktop (necessário após alterações de configuração)
2. Abra o menu de ferramentas - Procure pelo ícone de martelo no canto inferior esquerdo
3. Verifique se as ferramentas Bowlly aparecem - Você deve ver 5 ferramentas listadas
4. Teste com uma consulta: Tente perguntar "Encontre comidas secas para gatos sem grãos"

Solução de Problemas

Ferramentas não aparecem no Claude?

• Reinicie o Claude Desktop - Alterações de configuração exigem reinicialização
• Verifique o caminho do arquivo de configuração - Certifique-se de estar editando o arquivo correto para o seu sistema operacional
• Valide a sintaxe JSON - Use um validador JSON se tiver dúvidas
• Verifique os logs do Claude Desktop:
  • macOS: ~/Library/Logs/Claude/
  • Windows: %APPDATA%/Claude/Logs/
  • Linux: ~/.config/Claude/Logs/

Erros de "Comando não encontrado"?

• Certifique-se de que o Node.js 22+ está instalado: node --version
• Tente com npx: npx @bowlly/mcp-server --setup
• Alternativa de instalação global: npm install -g @bowlly/mcp-server

Configuração não persiste?

• Verifique as permissões do arquivo - Certifique-se de ter acesso de escrita ao diretório de configuração
• Use caminhos absolutos - Caminhos relativos podem não ser resolvidos corretamente
• Valide o formato JSON - Vírgulas ou colchetes ausentes são problemas comuns

Licença

MIT