Spoonacular Mcp

Spoonacular MCP 服务

一个可访问 Spoonacular Food API 的模型上下文协议（MCP）服务。此服务可让 AI 助手通过 MCP 协议搜索食谱、获取营养信息、查找食材等。

功能

• 食谱搜索：根据食材、饮食方式、菜系和其他条件搜索食谱
• 食谱信息：获取详细的食谱信息，包括食材、制作步骤和营养信息
• 食材搜索：查找并探索食材信息
• 营养分析：分析食材列表的营养成分
• 按食材查找食谱：根据现有食材查找食谱
• 随机食谱：获取随机食谱推荐，并可选择添加筛选条件

快速开始

安装

npm install -g spoonacular-mcp

设置

1. 获取 Spoonacular 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（字符串）：食谱搜索词
• number（数字，1-100）：结果数量（默认值：10）
• diet（字符串，可选）：饮食类型（素食、纯素、无麸质等）
• intolerances（字符串，可选）：以逗号分隔的不耐受成分
• includeIngredients（字符串，可选）：必需食材（以逗号分隔）
• excludeIngredients（字符串，可选）：要排除的食材（以逗号分隔）
• type（字符串，可选）：餐点类型（主菜、配菜、甜点等）
• cuisine（字符串，可选）：菜系类型（意大利菜、墨西哥菜、中餐等）

get_recipe_information

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

参数：

• id（数字）：食谱 ID
• includeNutrition（布尔值）：是否包含营养信息（默认值：false）

search_ingredients

按名称搜索食材。

参数：

• query（字符串）：食材搜索词
• number（数字，1-100）：结果数量（默认值：10）
• metaInformation（布尔值）：是否包含元信息（默认值：false）

analyze_nutrition

分析食材列表的营养成分。

参数：

• ingredientList（字符串）：食材列表，每行一个
• servings（数字）：份数

find_recipes_by_ingredients

根据现有食材查找食谱。

参数：

• ingredients（字符串）：以逗号分隔的现有食材列表
• 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 次请求
• 适用速率限制

生产环境使用时，可考虑升级到付费计划。

许可证

ISC

贡献

欢迎贡献！请随时提交 Pull Request。