食谱API服务

Spoonacular MCP服务器

一种模型上下文协议（MCP）服务器，提供对 虚假食品API该服务器使AI助手能够通过MCP协议搜索食谱、获取营养信息、查找配料等。

特性

• 食谱搜索：按配料、饮食、菜肴和其他标准搜索食谱
• 配方信息：获取详细的食谱信息，包括配料、说明和营养
• 成分搜索：查找和探索成分信息
• 营养分析：分析营养成分清单
• 按配料的食谱：根据可用成分查找食谱
• 随机食谱：通过可选过滤获取随机食谱建议

快速开始

安装

npm install -g spoonacular-mcp

设置

1. 获取虚假API密钥 （免费）https://spoonacular.com/food-api/console#Dashboard)

2. 将API密钥设置为环境变量：

   复制

   # Windows (PowerShell)
   $env:SPOONACULAR_API_KEY="your_api_key_here"
   
   # macOS/Linux
   export SPOONACULAR_API_KEY="your_api_key_here"
   

与MCP客户端一起使用

将此配置添加到您的MCP客户端（Claude Desktop等）：

{
  "servers": {
    "spoonacular": {
      "command": "spoonacular-mcp",
      "env": {
        "SPOONACULAR_API_KEY": "your_api_key_here"
      }
    }
  }
}

测试安装

# Set your API key
export SPOONACULAR_API_KEY="your_key_here"

# Test the server
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | spoonacular-mcp

可用工具

search_recipes

使用各种过滤器搜索食谱。

参数：

• query （string）：食谱搜索查询
• number （数字，1-100）：结果数量（默认值：10）
• diet （字符串，可选）：饮食类型（素食、纯素、无麸质等）
• intolerances （字符串，可选）：逗号分隔的不容忍度
• includeIngredients （字符串，可选）：必需成分（逗号分隔）
• excludeIngredients （字符串，可选）：要排除的成分（逗号分隔）
• type （字符串，可选）：用餐类型（主菜、配菜、甜点等）
• cuisine （字符串，可选）：烹饪类型（意大利、墨西哥、中国等）

get_recipe_information

获取特定食谱的详细信息。

参数：

• id （编号）：配方ID
• includeNutrition （boolean）：包含营养信息（默认值：false）

search_ingredients

按名称搜索配料。

参数：

• query （string）：成分搜索查询
• number （数字，1-100）：结果数量（默认值：10）
• metaInformation （boolean）：包含元信息（默认值：false）

analyze_nutrition

分析营养成分清单。

参数：

• ingredientList （string）：成分列表，每行一个
• servings （数量）：份数

find_recipes_by_ingredients

根据可用的食材找到食谱。

参数：

• ingredients （string）：以逗号分隔的可用成分列表
• number （数字，1-100）：配方数量（默认值：5）
• ranking （数字，1-2）：排名策略（1=最大化使用，2=最小化缺失）

get_random_recipes

通过可选过滤获取随机食谱。

参数：

• number （数字，1-100）：随机食谱的数量（默认值：1）
• tags （字符串，可选）：用于过滤的逗号分隔标签

发展

要在开发模式下运行：

npm run dev

要构建：

npm run build

API费率限制

免费Spoonacular API计划包括：

• 每天150个请求
• 利率限制适用

考虑升级到付费生产计划。

许可证

国际协调委员会

贡献

欢迎投稿！请随时提交拉取请求。