oishi-kenko-mcp MCP Server

Model Context Protocol (MCP) server for searching and formatting recipes from oishi-kenko.com.

Overview

This server exposes a single tool to build recipe search queries with rich filters (dish type, symptoms/concerns, cooking time, and method features), fetch the result page, and parse a structured recipe list.

Key Features

• Recipe search URL builder with validated parameters (Zod)
• HTML parsing via Cheerio to extract recipe cards
• Returns structured results (JSON) inside MCP content

Available Tools

1. search_recipe

Description: Build a query, fetch the recipes list page, parse, and return structured results.

Parameters:

• query (required, string): Main keyword (ingredient or dish name)
• page (optional, number): Page number for pagination
• exclusion_keyword (optional, string)
• recipe_author_name (optional, string)
• sort_by (optional, enum): date | popularity (default: date)
• dish_types (optional, DishType[]): main_dish | staple_food | side_dish | soup | sweets
• symptoms (optional, Symptom[]): e.g. want_to_reduce_salt, quick, soft, warm, ...
• cooking_time (optional, enum): less_than_5_min | less_than_15_min | ... | more_than_60_min
• cooking_method_features (optional, CookingMethodFeature[]): e.g. microwave_alone, pan_alone, no_knife_needed, ...
• original_keyword (optional, string)
• source (optional, string, default text_field)
• container (optional, string, default search_within_tab)

Returns: MCP content with one text item containing JSON array of recipes:

[
  {
    "id": "12345",
    "name": "大根サラダ",
    "description": "シャキシャキの大根を使った簡単サラダ",
    "url": "https://oishi-kenko.com/recipes/12345",
    "ingredients": "大根、ツナ、マヨネーズ…",
    "nutrition": { "エネルギー": { "value": 120, "unit": "kcal" } }
  }
]

Setup

Claude Desktop Configuration

claude_desktop_config.json に以下を追加します。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "oishi-kenko-mcp": {
      "command": "npx",
      "args": ["oishi-kenko-mcp"]
    }
  }
}

もしくはローカルのビルド成果物を直接指定する場合:

{
  "mcpServers": {
    "oishi-kenko-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/oishi-kenko-mcp/build/index.js"]
    }
  }
}

Usage Examples

Example 1: Minimal search

「だいこん」で検索:

Use tool: search_recipe
{
  "query": "だいこん"
}

Example 2: Quick microwave recipes

「電子レンジ」「すぐできる」を含むフィルタ検索:

Use tool: search_recipe
{
  "query": "チキン",
  "symptoms": ["quick"],
  "cooking_method_features": ["microwave_alone"],
  "cooking_time": "less_than_15_min"
}

Returned content

ツール結果は MCP の content に type: "text" で JSON 文字列が入ります。クライアント側で JSON パースして利用してください。

Development

Install dependencies:

npm install

Build the server:

npm run build

Run with MCP Inspector:

npm run dev

The Inspector will provide a local URL to test the tool.

Notes

• This server scrapes public recipe listing pages and parses visible card data. Markup changes on the source site may affect parsing.
• Be mindful of request frequency to avoid excessive load.