Bowlly Search

Servidor MCP de Bowlly

Servidor MCP (Model Context Protocol) para la búsqueda de productos de comida para gatos Bowlly y análisis de ingredientes. Permite a Claude Desktop buscar, analizar y comparar productos de comida para gatos.

Requisitos previos

• Node.js 22+ - Necesario para ejecutar el servidor MCP
• Claude Desktop - Descargar aquí si no está instalado

Inicio rápido

Opción 1: Configuración con un solo comando (Recomendada)

npx @bowlly/mcp-server --setup

Después de ejecutarlo, reinicia Claude Desktop y ¡listo!

Opción 2: Configuración manual

1. Edita la configuración de Claude Desktop en la ruta adecuada para tu sistema operativo:

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

2. Añade la configuración del servidor Bowlly:

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

3. Guarda el archivo y reinicia Claude Desktop

Herramientas disponibles

Herramienta	Descripción
search_products	Buscar por ingredientes, condiciones, forma
get_product_detail	Información completa del producto con ingredientes
compare_products	Comparación lado a lado
analyze_nutrition	Desglose de ingredientes y análisis de carbohidratos
get_curation_list	Recomendaciones de mejores por categoría

Ejemplos de consultas en lenguaje 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"

Configuración

Ubicaciones de archivos de configuración por plataforma

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

Verificación

Para confirmar que el servidor MCP está funcionando:

1. Reinicia Claude Desktop (necesario después de cambios de configuración)
2. Abre el menú de herramientas - Busca el ícono de martillo en la esquina inferior izquierda
3. Verifica que aparezcan las herramientas de Bowlly - Deberías ver 5 herramientas listadas
4. Prueba con una consulta: Intenta preguntar "Encuentra alimentos secos para gatos sin granos"

Solución de problemas

¿Las herramientas no aparecen en Claude?

• Reinicia Claude Desktop - Los cambios de configuración requieren un reinicio
• Verifica la ruta del archivo de configuración - Asegúrate de estar editando el archivo correcto para tu sistema operativo
• Verifica la sintaxis JSON - Usa un validador JSON si no estás seguro
• Revisa los registros de Claude Desktop:
  • macOS: ~/Library/Logs/Claude/
  • Windows: %APPDATA%/Claude/Logs/
  • Linux: ~/.config/Claude/Logs/

¿Errores de "Comando no encontrado"?

• Asegúrate de que Node.js 22+ esté instalado: node --version
• Prueba con npx: npx @bowlly/mcp-server --setup
• Alternativa de instalación global: npm install -g @bowlly/mcp-server

¿La configuración no se guarda?

• Verifica los permisos de archivo - Asegúrate de tener acceso de escritura al directorio de configuración
• Usa rutas absolutas - Las rutas relativas pueden no resolverse correctamente
• Valida el formato JSON - Las comas o corchetes faltantes son problemas comunes

Licencia

MIT