recipe-mcp

Recipe MCP Server

一个 MCP（Model Context Protocol）服务，提供 AI 驱动的食谱生成与转换工具。根据饮食偏好生成个性化食谱，将现有食谱调整为符合营养目标的版本，等等。

功能

• 🍳 生成食谱 - 根据自然语言描述创建自定义食谱
• 🔄 转换食谱 - 修改现有食谱（改为纯素、调整热量等）
• 🥗 饮食支持 - 处理过敏、饮食限制和食物偏好
• 📊 营养目标 - 满足特定的热量和蛋白质要求
• 🆓 开放访问 - 无需 API 密钥（有速率限制）

安装

用于 Claude Desktop

1. 安装 MCP 服务：

npm install -g @cookwith/recipe-mcp

2. 添加到 Claude Desktop 配置中：
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "recipe-mcp": {
      "command": "npx",
      "args": ["@cookwith/recipe-mcp"],
      "env": {
        "COOKWITH_API_URL": "https://cookwith.co"
      }
    }
  }
}

3. 重启 Claude Desktop

用于开发

# Clone the repository
git clone https://github.com/cookwith/recipe-mcp.git
cd recipe-mcp

# Install dependencies
npm install

# Run in development mode
npm run dev

使用示例

生成食谱

// In Claude Desktop, you can say:
"Generate a healthy Mediterranean pasta dish with lots of vegetables"

// The tool will be called with:
{
  "prompt": "A healthy Mediterranean pasta dish with lots of vegetables",
  "dietaryRestrictions": ["vegetarian"],
  "calories": "450",
  "servings": 4
}

转换食谱

// After generating or providing a recipe:
"Make this recipe vegan and reduce the calories by 200"

// The tool will be called with:
{
  "recipe": { /* existing recipe object */ },
  "instructions": "Make this vegan and reduce calories by 200",
  "calories": "350"
}

工具

generate_recipe

根据自然语言指令生成新食谱。

参数：

• prompt（string，必填）- 自然语言描述
• dietaryRestrictions（string[]，可选）- 例如，["vegetarian", "gluten-free"]
• allergies（string[]，可选）- 需要避免的食材
• dislikes（string[]，可选）- 需要排除的食物
• calories（string，可选）- 每份目标热量
• protein（string，可选）- 目标蛋白质克数
• servings（number，可选）- 份数（1-20，默认：4）

transform_recipe

根据指令转换现有食谱。

参数：

• recipe（object，必填）- 要转换的食谱
• instructions（string，必填）- 如何修改食谱
• calories（string，可选）- 新的目标热量
• protein（string，可选）- 新的目标蛋白质克数
• servings（number，可选）- 新的份数

速率限制

公共 API 有以下速率限制：

• 匿名访问：每个 IP 地址每小时 20 次请求
• 无需身份验证
• 超出限制时会提供 Retry-After 标头

食谱对象格式

interface Recipe {
  title: string;
  description: string;
  ingredients: string[];      // e.g., ["2 cups flour", "1 tsp salt"]
  instructions: string[];      // Step-by-step instructions
  servings: number;
  prepTime?: number;          // Minutes
  cookTime?: number;          // Minutes
  totalTime?: number;         // Minutes
  cuisine?: string;           // e.g., "Italian", "Mexican"
  course?: string;            // e.g., "main", "dessert"
  difficulty?: string;        // e.g., "easy", "medium", "hard"
  calories?: number;          // Per serving
  protein?: number;           // Grams per serving
  carbs?: number;            // Grams per serving
  fat?: number;              // Grams per serving
  fiber?: number;            // Grams per serving
  sugar?: number;            // Grams per serving
  sodium?: number;           // Milligrams per serving
}

配置

环境变量

• COOKWITH_API_URL - API 端点（默认：https://cookwith.co）

自定义 API 端点

用于开发或自托管实例：

export COOKWITH_API_URL=http://localhost:3000
npx @cookwith/recipe-mcp

示例

基本食谱生成

// Request
{
  "prompt": "Quick and easy chicken stir-fry"
}

// Response
{
  "title": "Quick Chicken Stir-Fry",
  "description": "A delicious and speedy chicken stir-fry...",
  "ingredients": [
    "2 chicken breasts, sliced",
    "2 cups mixed vegetables",
    "3 tbsp soy sauce",
    // ...
  ],
  "instructions": [
    "Heat oil in a large wok or skillet",
    "Add chicken and cook until golden",
    // ...
  ],
  "servings": 4,
  "prepTime": 10,
  "cookTime": 15,
  "calories": 320,
  "protein": 28
}

食谱转换

// Request
{
  "recipe": {
    "title": "Classic Beef Lasagna",
    "ingredients": ["1 lb ground beef", "ricotta cheese", ...],
    // ... full recipe
  },
  "instructions": "Make this vegetarian and lower in calories"
}

// Response
{
  "title": "Vegetarian Light Lasagna",
  "description": "A healthier vegetarian version...",
  "ingredients": [
    "2 cups chopped mushrooms",
    "1 cup low-fat ricotta",
    // ... transformed ingredients
  ],
  // ... rest of transformed recipe
}

故障排除

速率限制错误

如果收到 429 错误，说明已超出速率限制。请等待 retryAfter 字段指定的时间后再发送请求。

连接问题

请确保网络连接稳定，并且可以访问 API 端点。

参数无效

请检查参数是否符合预期格式和限制（例如，份数介于 1-20 之间）。

贡献

欢迎贡献！详情请参阅贡献指南。

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件。

支持

• 🐛 报告问题
• 💬 讨论
• 📧 电子邮件：[email protected]

技术支持

• Cookwith - AI 驱动的烹饪平台
• OpenAI GPT-4 - 食谱生成
• Model Context Protocol - 工具集成