Spoonacular MCP Server

一个提供对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"
      }
    }
  }
}

测试安装

# 设置您的API密钥
export SPOONACULAR_API_KEY="your_key_here"

# 测试服务器
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。 </中文翻译>