Bowlly

Bowlly MCP Server

用于搜索 Bowlly 猫粮产品和分析成分的 MCP（Model Context Protocol）服务。 让 Claude Desktop 能够搜索、分析和比较猫粮产品。

前置条件

• Node.js 22+ - 运行 MCP 服务所必需
• Claude Desktop - 如果尚未安装，请在此下载

快速开始

选项 1：一键设置（推荐）

npx @bowlly/mcp-server --setup

运行后，重启 Claude Desktop 即可开始使用！

选项 2：手动配置

1. 根据操作系统在相应路径编辑 Claude Desktop 配置文件：

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

2. 添加 Bowlly 服务配置：

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

3. 保存文件并重启 Claude Desktop

可用工具

工具	描述
search_products	按成分、健康状况和形态搜索
get_product_detail	获取包含成分的完整产品信息
compare_products	并排比较产品
analyze_nutrition	分解成分并分析碳水化合物
get_curation_list	获取精选品类推荐

自然语言查询示例

"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"

配置

各平台的配置文件位置

平台	路径
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%/Claude/claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

验证

确认 MCP 服务正常运行：

1. 重启 Claude Desktop（配置更改后必须重启）
2. 打开工具菜单 - 找到左下角的锤子图标
3. 确认 Bowlly 工具已显示 - 应该能看到 5 个工具
4. 测试查询：尝试询问“查找无谷物的干猫粮”

故障排除

Claude 中没有显示工具？

• 重启 Claude Desktop - 配置更改后必须重启
• 检查配置文件路径 - 确保编辑的是适用于你操作系统的正确文件
• 验证 JSON 语法 - 不确定时，请使用 JSON 验证器
• 检查 Claude Desktop 日志：
  • macOS：~/Library/Logs/Claude/
  • Windows：%APPDATA%/Claude/Logs/
  • Linux：~/.config/Claude/Logs/

出现“找不到命令”错误？

• 确保已安装 Node.js 22+：node --version
• 尝试使用 npx：npx @bowlly/mcp-server --setup
• 备用方案：全局安装：npm install -g @bowlly/mcp-server

配置无法保留？

• 检查文件权限 - 确保你拥有配置目录的写入权限
• 使用绝对路径 - 相对路径可能无法正确解析
• 验证 JSON 格式 - 缺少逗号或括号是常见问题

许可证

MIT