Spoonacular Mcp

Spoonacular MCP サーバー

Spoonacular Food API にアクセスできる Model Context Protocol（MCP）サーバーです。このサーバーを使用すると、MCP プロトコルを通じて、AI アシスタントがレシピの検索、栄養情報の取得、食材の検索などを行えます。

機能

• レシピ検索：食材、食事制限、料理の種類など、さまざまな条件でレシピを検索します
• レシピ情報：食材、作り方、栄養情報など、レシピの詳細を取得します
• 食材検索：食材の情報を検索、確認します
• 栄養分析：食材リストの栄養を分析します
• 食材からレシピを検索：手元にある食材をもとにレシピを検索します
• ランダムなレシピ：必要に応じて条件を指定し、ランダムなレシピの提案を取得します

クイックスタート

インストール

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（string）：レシピの検索クエリ
• number（number, 1-100）：結果数（デフォルト：10）
• diet（string, optional）：食事の種類（ベジタリアン、ビーガン、グルテンフリーなど）
• intolerances（string, optional）：カンマ区切りの不耐症
• includeIngredients（string, optional）：必須の食材（カンマ区切り）
• excludeIngredients（string, optional）：除外する食材（カンマ区切り）
• type（string, optional）：食事の種類（メインコース、サイドディッシュ、デザートなど）
• cuisine（string, optional）：料理の種類（イタリア料理、メキシコ料理、中華料理など）

get_recipe_information

特定のレシピに関する詳細情報を取得します。

パラメーター：

• id（number）：レシピ ID
• includeNutrition（boolean）：栄養情報を含めるかどうか（デフォルト：false）

search_ingredients

名前で食材を検索します。

パラメーター：

• query（string）：食材の検索クエリ
• number（number, 1-100）：結果数（デフォルト：10）
• metaInformation（boolean）：メタ情報を含めるかどうか（デフォルト：false）

analyze_nutrition

食材リストの栄養を分析します。

パラメーター：

• ingredientList（string）：食材リスト。1 行に 1 つずつ記載します
• servings（number）：分量

find_recipes_by_ingredients

手元にある食材をもとにレシピを検索します。

パラメーター：

• ingredients（string）：使用可能な食材のカンマ区切りリスト
• number（number, 1-100）：レシピ数（デフォルト：5）
• ranking（number, 1-2）：ランキング方式（1＝使用する食材を最大化、2＝不足する食材を最小化）

get_random_recipes

必要に応じて条件を指定し、ランダムなレシピを取得します。

パラメーター：

• number（number, 1-100）：ランダムなレシピの数（デフォルト：1）
• tags（string, optional）：絞り込み用のカンマ区切りタグ

開発

開発モードで実行するには：

npm run dev

ビルドするには：

npm run build

API のレート制限

Spoonacular API の無料プランには、以下の制限があります：

• 1 日あたり 150 リクエスト
• レート制限が適用されます

本番環境での使用には、有料プランへのアップグレードをご検討ください。

ライセンス

ISC

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。